spactureai-mobile-player 1.0.30

package/src/expo-plugins/withReactNativeVideo.ts

@@ -0,0 +1,32 @@
+import { type ConfigPlugin, createRunOncePlugin } from '@expo/config-plugins';
+import type { ConfigProps } from './@types';
+import { getPackageInfo } from './getPackageInfo';
+import { withAndroidExtensions } from './withAndroidExtensions';
+import { withAndroidPictureInPicture } from './withAndroidPictureInPicture';
+import { withBackgroundAudio } from './withBackgroundAudio';
+import { withAndroidNotificationControls } from './withAndroidNotificationControls';
+
+const withRNVideo: ConfigPlugin<ConfigProps> = (config, props = {}) => {
+  if (props.enableAndroidPictureInPicture) {
+    config = withAndroidPictureInPicture(
+      config,
+      props.enableAndroidPictureInPicture
+    );
+  }
+
+  if (props.androidExtensions != null) {
+    config = withAndroidExtensions(config, props.androidExtensions);
+  }
+
+  if (props.enableBackgroundAudio) {
+    config = withBackgroundAudio(config, props.enableBackgroundAudio);
+  }
+
+  config = withAndroidNotificationControls(config);
+
+  return config;
+};
+
+const { name, version } = getPackageInfo();
+
+export default createRunOncePlugin(withRNVideo, name, version);

package/src/expo-plugins/writeToPodfile.ts

@@ -0,0 +1,74 @@
+import { mergeContents } from '@expo/config-plugins/build/utils/generateCode';
+import fs from 'fs';
+import path from 'path';
+
+export const writeToPodfile = (
+  projectRoot: string,
+  key: string,
+  value: string,
+  testApp: boolean = false
+) => {
+  const podfilePath = path.join(projectRoot, 'ios', 'Podfile');
+  const podfileContent = fs.readFileSync(podfilePath, 'utf8');
+
+  if (podfileContent.includes(`$${key} =`)) {
+    console.warn(
+      `RNV - Podfile already contains a definition for "$${key}". Skipping...`
+    );
+    return;
+  }
+
+  if (testApp) {
+    mergeTestAppPodfile(podfileContent, podfilePath, key, value);
+  } else {
+    mergeExpoPodfile(podfileContent, podfilePath, key, value);
+  }
+};
+
+const mergeTestAppPodfile = (
+  podfileContent: string,
+  podfilePath: string,
+  key: string,
+  value: string
+) => {
+  // We will try to inject the variable definition above the `use_test_app!` call in the Podfile.
+  const newPodfileContent = mergeContents({
+    tag: `rn-video-set-${key.toLowerCase()}`,
+    src: podfileContent,
+    newSrc: `$${key} = ${value}`,
+    anchor: /use_test_app!/,
+    offset: -1, // Insert the key-value pair just above the `use_test_app!` call.
+    comment: '#',
+  });
+
+  // Write to Podfile only if the merge was successful
+  if (newPodfileContent.didMerge) {
+    fs.writeFileSync(podfilePath, newPodfileContent.contents);
+  } else {
+    console.warn(
+      `RNV - Failed to write "$${key} = ${value}" to Test App Podfile`
+    );
+  }
+};
+
+const mergeExpoPodfile = (
+  podfileContent: string,
+  podfilePath: string,
+  key: string,
+  value: string
+) => {
+  const newPodfileContent = mergeContents({
+    tag: `rn-video-set-${key.toLowerCase()}`,
+    src: podfileContent,
+    newSrc: `$${key} = ${value}`,
+    anchor: /platform :ios/,
+    offset: 0,
+    comment: '#',
+  });
+
+  if (newPodfileContent.didMerge) {
+    fs.writeFileSync(podfilePath, newPodfileContent.contents);
+  } else {
+    console.warn(`RNV - Failed to write "$${key} = ${value}" to Podfile`);
+  }
+};

package/src/index.tsx

@@ -0,0 +1,29 @@
+export { useEvent } from './core/hooks/useEvent';
+export { useVideoPlayer } from './core/hooks/useVideoPlayer';
+export * from './core/types/Events';
+export type { IgnoreSilentSwitchMode } from './core/types/IgnoreSilentSwitchMode';
+export type { MixAudioMode } from './core/types/MixAudioMode';
+export type { ResizeMode } from './core/types/ResizeMode';
+export type { TextTrack } from './core/types/TextTrack';
+export type { VideoConfig, VideoSource } from './core/types/VideoConfig';
+export {
+  type LibraryError,
+  type PlayerError,
+  type SourceError,
+  type UnknownError,
+  type VideoComponentError,
+  type VideoError,
+  type VideoErrorCode,
+  type VideoRuntimeError,
+  type VideoViewError,
+} from './core/types/VideoError';
+export type { VideoPlayerStatus } from './core/types/VideoPlayerStatus';
+export {
+  default as VideoView,
+  default as UnifiedPlayerView,
+  type VideoViewProps,
+  type VideoViewProps as UnifiedPlayerViewProps,
+  type VideoViewRef,
+  type VideoViewRef as UnifiedPlayerViewRef,
+} from './core/video-view/VideoView';
+export { VideoPlayer } from './core/VideoPlayer';

package/src/spec/fabric/VideoViewNativeComponent.ts

@@ -0,0 +1,17 @@
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import type { ViewProps } from 'react-native';
+import type { Int32 } from 'react-native/Libraries/Types/CodegenTypes';
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+
+type OnNitroIdChangeEvent = Readonly<{
+  nitroId: Int32;
+}>;
+
+export interface NativeProps extends ViewProps {
+  nitroId: Int32;
+  onNitroIdChange?: DirectEventHandler<OnNitroIdChangeEvent>;
+}
+
+export default codegenNativeComponent<NativeProps>('RNCVideoView', {
+  paperComponentName: 'RNCVideoView',
+});

package/src/spec/nitro/VideoPlayer.nitro.ts

@@ -0,0 +1,62 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { TextTrack } from '../../core/types/TextTrack';
+import type { VideoPlayerBase } from '../../core/types/VideoPlayerBase';
+import type { VideoPlayerEventEmitter } from './VideoPlayerEventEmitter.nitro';
+import type { VideoPlayerSource } from './VideoPlayerSource.nitro';
+
+export interface VideoPlayer
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }>,
+    VideoPlayerBase {
+  // Override with (hybrid) VideoPlayerSource
+  readonly source: VideoPlayerSource;
+
+  // Holder of the video player events.
+  readonly eventEmitter: VideoPlayerEventEmitter;
+
+  /**
+   * Show playback controls in the notifications area
+   *
+   * @note on Android, this can be overridden by {@linkcode VideoPlayer.playInBackground}, as Android requires
+   * a foreground service to show notifications while the app is in the background.
+   *
+   * @default false
+   */
+  showNotificationControls: boolean;
+
+  /**
+   * Replace the current source of the player.
+   * @param source - The new source of the video.
+   * @note If you want to clear the source, you can pass null. It has the same effect as {@link release}.
+   * see {@link VideoPlayerSourceBase}
+   */
+  replaceSourceAsync(source: VideoPlayerSource | null): Promise<void>;
+
+  /**
+   * Get all available text tracks for the current source.
+   * @returns Array of available text tracks
+   */
+  getAvailableTextTracks(): TextTrack[];
+
+  /**
+   * Select a text track to display.
+   * @param textTrack - Text track to select, or null to unselect current track
+   */
+  selectTextTrack(textTrack: TextTrack | null): void;
+
+  /**
+   * Releases the player's native resources and releases native state.
+   */
+  release(): void;
+
+  /**
+   * Capture the current video frame as a base64 encoded image.
+   * @returns A promise that resolves to the base64 encoded image string (PNG format).
+   * @note The image will be captured at the current playback position.
+   */
+  captureFrame(): Promise<string>;
+}
+
+export interface VideoPlayerFactory
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  createPlayer(source: VideoPlayerSource): VideoPlayer;
+}

package/src/spec/nitro/VideoPlayerEventEmitter.nitro.ts

@@ -0,0 +1,207 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type {
+  BandwidthData,
+  onLoadData,
+  onLoadStartData,
+  onPlaybackStateChangeData,
+  onProgressData,
+  onVolumeChangeData,
+  TimedMetadata,
+} from '../../core/types/Events';
+import type { TextTrack } from '../../core/types/TextTrack';
+import type { VideoPlayerStatus } from '../../core/types/VideoPlayerStatus';
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import type { VideoPlayerEvents } from '../../core/types/Events';
+
+export interface ListenerSubscription {
+  remove(): void;
+}
+
+export interface VideoPlayerEventEmitter
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /**
+   * Adds a listener for the `onAudioBecomingNoisy` event.
+   * @see {@link VideoPlayerEvents.onAudioBecomingNoisy}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnAudioBecomingNoisyListener(listener: () => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onAudioFocusChange` event.
+   * @see {@link VideoPlayerEvents.onAudioFocusChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnAudioFocusChangeListener(
+    listener: (hasAudioFocus: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onBandwidthUpdate` event.
+   * @see {@link VideoPlayerEvents.onBandwidthUpdate}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnBandwidthUpdateListener(
+    listener: (data: BandwidthData) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onBuffer` event.
+   * @see {@link VideoPlayerEvents.onBuffer}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnBufferListener(
+    listener: (buffering: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onControlsVisibleChange` event.
+   * @see {@link VideoPlayerEvents.onControlsVisibleChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnControlsVisibleChangeListener(
+    listener: (visible: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onEnd` event.
+   * @see {@link VideoPlayerEvents.onEnd}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnEndListener(listener: () => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onExternalPlaybackChange` event.
+   * @see {@link VideoPlayerEvents.onExternalPlaybackChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnExternalPlaybackChangeListener(
+    listener: (externalPlaybackActive: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onLoad` event.
+   * @see {@link VideoPlayerEvents.onLoad}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnLoadListener(listener: (data: onLoadData) => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onLoadStart` event.
+   * @see {@link VideoPlayerEvents.onLoadStart}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnLoadStartListener(
+    listener: (data: onLoadStartData) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onPlaybackStateChange` event.
+   * @see {@link VideoPlayerEvents.onPlaybackStateChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnPlaybackStateChangeListener(
+    listener: (data: onPlaybackStateChangeData) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onPlaybackRateChange` event.
+   * @see {@link VideoPlayerEvents.onPlaybackRateChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnPlaybackRateChangeListener(
+    listener: (rate: number) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onProgress` event.
+   * @see {@link VideoPlayerEvents.onProgress}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnProgressListener(
+    listener: (data: onProgressData) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onReadyToDisplay` event.
+   * @see {@link VideoPlayerEvents.onReadyToDisplay}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnReadyToDisplayListener(listener: () => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onSeek` event.
+   * @see {@link VideoPlayerEvents.onSeek}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnSeekListener(listener: (position: number) => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onStatusChange` event.
+   * @see {@link VideoPlayerEvents.onStatusChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnStatusChangeListener(
+    listener: (status: VideoPlayerStatus) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onTimedMetadata` event.
+   * @see {@link VideoPlayerEvents.onTimedMetadata}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnTimedMetadataListener(
+    listener: (data: TimedMetadata) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onTextTrackDataChanged` event.
+   * @see {@link VideoPlayerEvents.onTextTrackDataChanged}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnTextTrackDataChangedListener(
+    listener: (data: string[]) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onTrackChange` event.
+   * @see {@link VideoPlayerEvents.onTrackChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnTrackChangeListener(
+    listener: (track: TextTrack | null) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onVolumeChange` event.
+   * @see {@link VideoPlayerEvents.onVolumeChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnVolumeChangeListener(
+    listener: (data: onVolumeChangeData) => void
+  ): ListenerSubscription;
+
+  /**
+   * Clears all listeners from the event emitter.
+   */
+  clearAllListeners(): void;
+}

package/src/spec/nitro/VideoPlayerSource.nitro.ts

@@ -0,0 +1,18 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { NativeVideoConfig } from '../../core/types/VideoConfig';
+import type { VideoPlayerSourceBase } from '../../core/types/VideoPlayerSourceBase';
+
+/**
+ * A source for a {@link VideoPlayer}.
+ * Source cannot be changed after it is created. If you need to update the source, you need to create a new one.
+ * It provides functions to get information about the asset.
+ */
+export interface VideoPlayerSource
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }>,
+    VideoPlayerSourceBase {}
+
+export interface VideoPlayerSourceFactory
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  fromUri(uri: string): VideoPlayerSource;
+  fromVideoConfig(config: NativeVideoConfig): VideoPlayerSource;
+}

package/src/spec/nitro/VideoViewViewManager.nitro.ts

@@ -0,0 +1,92 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { ResizeMode } from '../../core/types/ResizeMode';
+import type { VideoPlayer } from './VideoPlayer.nitro';
+import type { ListenerSubscription } from './VideoPlayerEventEmitter.nitro';
+
+export type SurfaceType = 'surface' | 'texture';
+
+// @internal
+export interface VideoViewViewManager
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  player?: VideoPlayer;
+  controls: boolean;
+  pictureInPicture: boolean;
+  autoEnterPictureInPicture: boolean;
+  resizeMode: ResizeMode;
+  enterFullscreen(): void;
+  exitFullscreen(): void;
+  enterPictureInPicture(): void;
+  exitPictureInPicture(): void;
+  canEnterPictureInPicture(): boolean;
+  keepScreenAwake: boolean;
+  surfaceType: SurfaceType;
+
+  // Event listeners
+
+  /**
+   * Adds a listener for the `onPictureInPictureChange` event.
+   * @see {@link VideoViewEvents.onPictureInPictureChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnPictureInPictureChangeListener(
+    listener: (isInPictureInPicture: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `onFullscreenChange` event.
+   * @see {@link VideoViewEvents.onFullscreenChange}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addOnFullscreenChangeListener(
+    listener: (fullscreen: boolean) => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `willEnterFullscreen` event.
+   * @see {@link VideoViewEvents.willEnterFullscreen}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addWillEnterFullscreenListener(listener: () => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `willExitFullscreen` event.
+   * @see {@link VideoViewEvents.willExitFullscreen}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addWillExitFullscreenListener(listener: () => void): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `willEnterPictureInPicture` event.
+   * @see {@link VideoViewEvents.willEnterPictureInPicture}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addWillEnterPictureInPictureListener(
+    listener: () => void
+  ): ListenerSubscription;
+
+  /**
+   * Adds a listener for the `willExitPictureInPicture` event.
+   * @see {@link VideoViewEvents.willExitPictureInPicture}
+   * @param listener - The listener to add.
+   * @returns A subscription object that can be used to remove the listener.
+   */
+  addWillExitPictureInPictureListener(
+    listener: () => void
+  ): ListenerSubscription;
+
+  /**
+   * Clears all listeners from the event emitter.
+   */
+  clearAllListeners(): void;
+}
+
+// @internal
+export interface VideoViewViewManagerFactory
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  createViewManager(nitroId: number): VideoViewViewManager;
+}