expo-realtime-ivs-broadcast 0.1.10 → 0.2.0

package/build/index.d.ts

@@ -1,5 +1,5 @@
 import { EventSubscription } from 'expo-modules-core';
-import { LocalAudioConfig, LocalVideoConfig, PermissionStatusMap, StageConnectionStatePayload, PublishStatePayload, StageErrorPayload, CameraSwappedPayload, CameraSwapErrorPayload, ParticipantPayload, ParticipantStreamsPayload, ParticipantStreamsRemovedPayload } from './ExpoRealtimeIvsBroadcast.types';
+import { LocalAudioConfig, LocalVideoConfig, PermissionStatusMap, StageConnectionStatePayload, PublishStatePayload, StageErrorPayload, CameraSwappedPayload, CameraSwapErrorPayload, ParticipantPayload, ParticipantStreamsPayload, ParticipantStreamsRemovedPayload, PiPOptions, PiPStateChangedPayload, PiPErrorPayload } from './ExpoRealtimeIvsBroadcast.types';
 export * from './ExpoRealtimeIvsBroadcast.types';
 export { ExpoIVSStagePreviewView } from './ExpoIVSStagePreviewView';
 export { ExpoIVSRemoteStreamView } from './ExpoIVSRemoteStreamView';
@@ -23,4 +23,63 @@ export declare function addOnParticipantJoinedListener(listener: (event: Partici
 export declare function addOnParticipantLeftListener(listener: (event: ParticipantPayload) => void): EventSubscription;
 export declare function addOnParticipantStreamsAddedListener(listener: (event: ParticipantStreamsPayload) => void): EventSubscription;
 export declare function addOnParticipantStreamsRemovedListener(listener: (event: ParticipantStreamsRemovedPayload) => void): EventSubscription;
+/**
+ * Enable Picture-in-Picture mode with the given options.
+ *
+ * @param options Configuration options for PiP behavior
+ * @returns Promise resolving to true if PiP was enabled successfully
+ *
+ * @platform iOS 15.0+, Android 8.0+ (API 26+)
+ *
+ * @remarks
+ * - iOS: Requires `UIBackgroundModes` with `audio` in Info.plist for background playback
+ * - Android: The consuming app must add `android:supportsPictureInPicture="true"` to their Activity
+ */
+export declare function enablePictureInPicture(options?: PiPOptions): Promise<boolean>;
+/**
+ * Disable Picture-in-Picture mode and clean up resources.
+ */
+export declare function disablePictureInPicture(): Promise<void>;
+/**
+ * Manually start Picture-in-Picture mode.
+ * PiP must be enabled first via `enablePictureInPicture()`.
+ */
+export declare function startPictureInPicture(): Promise<void>;
+/**
+ * Stop Picture-in-Picture mode and return to full screen.
+ *
+ * @remarks
+ * On Android, this is a hint to the system - PiP is typically exited by user interaction.
+ */
+export declare function stopPictureInPicture(): Promise<void>;
+/**
+ * Check if Picture-in-Picture is currently active.
+ *
+ * @returns Promise resolving to true if PiP is currently active
+ */
+export declare function isPictureInPictureActive(): Promise<boolean>;
+/**
+ * Check if Picture-in-Picture is supported on this device.
+ *
+ * @returns Promise resolving to true if PiP is supported
+ *
+ * @remarks
+ * - iOS: Requires iOS 15.0+
+ * - Android: Requires Android 8.0+ (API 26+) and device/activity support
+ */
+export declare function isPictureInPictureSupported(): Promise<boolean>;
+/**
+ * Add a listener for PiP state changes.
+ *
+ * @param listener Callback function receiving state: 'started' | 'stopped' | 'restored'
+ * @returns EventSubscription to remove the listener
+ */
+export declare function addOnPiPStateChangedListener(listener: (event: PiPStateChangedPayload) => void): EventSubscription;
+/**
+ * Add a listener for PiP errors.
+ *
+ * @param listener Callback function receiving error message
+ * @returns EventSubscription to remove the listener
+ */
+export declare function addOnPiPErrorListener(listener: (event: PiPErrorPayload) => void): EventSubscription;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,gCAAgC,EACnC,MAAM,kCAAkC,CAAC;AAG1C,cAAc,kCAAkC,CAAC;AAGjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnH;AAED,wBAAsB,sBAAsB,CAAC,WAAW,CAAC,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1H;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAExG;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEvE;AAGD,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,GACrD,iBAAiB,CAEnB;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC7C,iBAAiB,CAEnB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC3C,iBAAiB,CAEnB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAC9C,iBAAiB,CAEnB;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAChD,iBAAiB,CAEnB;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,iBAAiB,CAEnB;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,iBAAiB,CAEnB;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,iBAAiB,CAEnB;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,GAC1D,iBAAiB,CAEnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -59,4 +59,81 @@ export function addOnParticipantStreamsAddedListener(listener) {
 export function addOnParticipantStreamsRemovedListener(listener) {
     return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantStreamsRemoved', listener);
 }
+// --- Picture-in-Picture Methods ---
+/**
+ * Enable Picture-in-Picture mode with the given options.
+ *
+ * @param options Configuration options for PiP behavior
+ * @returns Promise resolving to true if PiP was enabled successfully
+ *
+ * @platform iOS 15.0+, Android 8.0+ (API 26+)
+ *
+ * @remarks
+ * - iOS: Requires `UIBackgroundModes` with `audio` in Info.plist for background playback
+ * - Android: The consuming app must add `android:supportsPictureInPicture="true"` to their Activity
+ */
+export async function enablePictureInPicture(options) {
+    return await ExpoRealtimeIvsBroadcastModule.enablePictureInPicture(options);
+}
+/**
+ * Disable Picture-in-Picture mode and clean up resources.
+ */
+export async function disablePictureInPicture() {
+    return await ExpoRealtimeIvsBroadcastModule.disablePictureInPicture();
+}
+/**
+ * Manually start Picture-in-Picture mode.
+ * PiP must be enabled first via `enablePictureInPicture()`.
+ */
+export async function startPictureInPicture() {
+    return await ExpoRealtimeIvsBroadcastModule.startPictureInPicture();
+}
+/**
+ * Stop Picture-in-Picture mode and return to full screen.
+ *
+ * @remarks
+ * On Android, this is a hint to the system - PiP is typically exited by user interaction.
+ */
+export async function stopPictureInPicture() {
+    return await ExpoRealtimeIvsBroadcastModule.stopPictureInPicture();
+}
+/**
+ * Check if Picture-in-Picture is currently active.
+ *
+ * @returns Promise resolving to true if PiP is currently active
+ */
+export async function isPictureInPictureActive() {
+    return await ExpoRealtimeIvsBroadcastModule.isPictureInPictureActive();
+}
+/**
+ * Check if Picture-in-Picture is supported on this device.
+ *
+ * @returns Promise resolving to true if PiP is supported
+ *
+ * @remarks
+ * - iOS: Requires iOS 15.0+
+ * - Android: Requires Android 8.0+ (API 26+) and device/activity support
+ */
+export async function isPictureInPictureSupported() {
+    return await ExpoRealtimeIvsBroadcastModule.isPictureInPictureSupported();
+}
+// --- PiP Event Listeners ---
+/**
+ * Add a listener for PiP state changes.
+ *
+ * @param listener Callback function receiving state: 'started' | 'stopped' | 'restored'
+ * @returns EventSubscription to remove the listener
+ */
+export function addOnPiPStateChangedListener(listener) {
+    return ExpoRealtimeIvsBroadcastModule.addListener('onPiPStateChanged', listener);
+}
+/**
+ * Add a listener for PiP errors.
+ *
+ * @param listener Callback function receiving error message
+ * @returns EventSubscription to remove the listener
+ */
+export function addOnPiPErrorListener(listener) {
+    return ExpoRealtimeIvsBroadcastModule.addListener('onPiPError', listener);
+}
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,8BAA8B,MAAM,kCAAkC,CAAC;AAe9E,iCAAiC;AACjC,cAAc,kCAAkC,CAAC;AAEjD,oCAAoC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAA8B,EAAE,WAA8B;IAClG,OAAO,MAAM,8BAA8B,CAAC,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAA8B,EAAE,WAA8B;IACzG,OAAO,MAAM,8BAA8B,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,OAA0C;IACvF,OAAO,MAAM,8BAA8B,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,MAAM,8BAA8B,CAAC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAkB;IAC1D,OAAO,MAAM,8BAA8B,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,MAAM,8BAA8B,CAAC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACrD,OAAO,MAAM,8BAA8B,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,MAAM,8BAA8B,CAAC,kBAAkB,EAAE,CAAC;AACnE,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,wCAAwC,CACtD,QAAsD;IAEtD,OAAO,8BAA8B,CAAC,WAAW,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAA8C;IAE9C,OAAO,8BAA8B,CAAC,WAAW,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA4C;IAE5C,OAAO,8BAA8B,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA+C;IAE/C,OAAO,8BAA8B,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAiD;IAEjD,OAAO,8BAA8B,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAA6C;IAE7C,OAAO,8BAA8B,CAAC,WAAW,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAA6C;IAE7C,OAAO,8BAA8B,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAAoD;IAEpD,OAAO,8BAA8B,CAAC,WAAW,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,QAA2D;IAE3D,OAAO,8BAA8B,CAAC,WAAW,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["import { EventSubscription } from 'expo-modules-core';\nimport ExpoRealtimeIvsBroadcastModule from './ExpoRealtimeIvsBroadcastModule';\nimport { \n    LocalAudioConfig, \n    LocalVideoConfig, \n    PermissionStatusMap,\n    StageConnectionStatePayload,\n    PublishStatePayload,\n    StageErrorPayload,\n    CameraSwappedPayload,\n    CameraSwapErrorPayload,\n    ParticipantPayload,\n    ParticipantStreamsPayload,\n    ParticipantStreamsRemovedPayload,\n} from './ExpoRealtimeIvsBroadcast.types';\n\n// Re-export all type definitions\nexport * from './ExpoRealtimeIvsBroadcast.types';\n\n// Export the native view components\nexport { ExpoIVSStagePreviewView } from './ExpoIVSStagePreviewView';\nexport { ExpoIVSRemoteStreamView } from './ExpoIVSRemoteStreamView';\n\n// Export the custom hook\nexport { useStageParticipants } from './useStageParticipants';\n\n// --- Native Module Methods ---\nexport async function initializeStage(audioConfig?: LocalAudioConfig, videoConfig?: LocalVideoConfig): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.initializeStage(audioConfig, videoConfig);\n}\n\nexport async function initializeLocalStreams(audioConfig?: LocalAudioConfig, videoConfig?: LocalVideoConfig): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.initializeLocalStreams(audioConfig, videoConfig);\n}\n\nexport async function joinStage(token: string, options?: { targetParticipantId?: string }): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.joinStage(token, options);\n}\n\nexport async function leaveStage(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.leaveStage();\n}\n\nexport async function setStreamsPublished(published: boolean): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.setStreamsPublished(published);\n}\n\nexport async function swapCamera(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.swapCamera();\n}\n\nexport async function setMicrophoneMuted(muted: boolean): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.setMicrophoneMuted(muted);\n}\n\nexport async function requestPermissions(): Promise<PermissionStatusMap> {\n  return await ExpoRealtimeIvsBroadcastModule.requestPermissions();\n}\n\n// --- Event Emitter ---\nexport function addOnStageConnectionStateChangedListener(\n  listener: (event: StageConnectionStatePayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onStageConnectionStateChanged', listener);\n}\n\nexport function addOnPublishStateChangedListener(\n  listener: (event: PublishStatePayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onPublishStateChanged', listener);\n}\n\nexport function addOnStageErrorListener(\n  listener: (event: StageErrorPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onStageError', listener);\n}\n\nexport function addOnCameraSwappedListener(\n  listener: (event: CameraSwappedPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onCameraSwapped', listener);\n}\n\nexport function addOnCameraSwapErrorListener(\n  listener: (event: CameraSwapErrorPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onCameraSwapError', listener);\n}\n\nexport function addOnParticipantJoinedListener(\n  listener: (event: ParticipantPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantJoined', listener);\n}\n\nexport function addOnParticipantLeftListener(\n  listener: (event: ParticipantPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantLeft', listener);\n}\n\nexport function addOnParticipantStreamsAddedListener(\n  listener: (event: ParticipantStreamsPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantStreamsAdded', listener);\n}\n\nexport function addOnParticipantStreamsRemovedListener(\n  listener: (event: ParticipantStreamsRemovedPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantStreamsRemoved', listener);\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,8BAA8B,MAAM,kCAAkC,CAAC;AAkB9E,iCAAiC;AACjC,cAAc,kCAAkC,CAAC;AAEjD,oCAAoC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAA8B,EAAE,WAA8B;IAClG,OAAO,MAAM,8BAA8B,CAAC,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAA8B,EAAE,WAA8B;IACzG,OAAO,MAAM,8BAA8B,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,OAA0C;IACvF,OAAO,MAAM,8BAA8B,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,MAAM,8BAA8B,CAAC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAkB;IAC1D,OAAO,MAAM,8BAA8B,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,MAAM,8BAA8B,CAAC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACrD,OAAO,MAAM,8BAA8B,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,MAAM,8BAA8B,CAAC,kBAAkB,EAAE,CAAC;AACnE,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,wCAAwC,CACtD,QAAsD;IAEtD,OAAO,8BAA8B,CAAC,WAAW,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAA8C;IAE9C,OAAO,8BAA8B,CAAC,WAAW,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA4C;IAE5C,OAAO,8BAA8B,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA+C;IAE/C,OAAO,8BAA8B,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAiD;IAEjD,OAAO,8BAA8B,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAA6C;IAE7C,OAAO,8BAA8B,CAAC,WAAW,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAA6C;IAE7C,OAAO,8BAA8B,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAAoD;IAEpD,OAAO,8BAA8B,CAAC,WAAW,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,QAA2D;IAE3D,OAAO,8BAA8B,CAAC,WAAW,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;AAC7F,CAAC;AAED,qCAAqC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAoB;IAC/D,OAAO,MAAM,8BAA8B,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,MAAM,8BAA8B,CAAC,uBAAuB,EAAE,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,OAAO,MAAM,8BAA8B,CAAC,qBAAqB,EAAE,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,OAAO,MAAM,8BAA8B,CAAC,oBAAoB,EAAE,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,OAAO,MAAM,8BAA8B,CAAC,wBAAwB,EAAE,CAAC;AACzE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAC/C,OAAO,MAAM,8BAA8B,CAAC,2BAA2B,EAAE,CAAC;AAC5E,CAAC;AAED,8BAA8B;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAiD;IAEjD,OAAO,8BAA8B,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA0C;IAE1C,OAAO,8BAA8B,CAAC,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import { EventSubscription } from 'expo-modules-core';\nimport ExpoRealtimeIvsBroadcastModule from './ExpoRealtimeIvsBroadcastModule';\nimport { \n    LocalAudioConfig, \n    LocalVideoConfig, \n    PermissionStatusMap,\n    StageConnectionStatePayload,\n    PublishStatePayload,\n    StageErrorPayload,\n    CameraSwappedPayload,\n    CameraSwapErrorPayload,\n    ParticipantPayload,\n    ParticipantStreamsPayload,\n    ParticipantStreamsRemovedPayload,\n    PiPOptions,\n    PiPStateChangedPayload,\n    PiPErrorPayload,\n} from './ExpoRealtimeIvsBroadcast.types';\n\n// Re-export all type definitions\nexport * from './ExpoRealtimeIvsBroadcast.types';\n\n// Export the native view components\nexport { ExpoIVSStagePreviewView } from './ExpoIVSStagePreviewView';\nexport { ExpoIVSRemoteStreamView } from './ExpoIVSRemoteStreamView';\n\n// Export the custom hook\nexport { useStageParticipants } from './useStageParticipants';\n\n// --- Native Module Methods ---\nexport async function initializeStage(audioConfig?: LocalAudioConfig, videoConfig?: LocalVideoConfig): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.initializeStage(audioConfig, videoConfig);\n}\n\nexport async function initializeLocalStreams(audioConfig?: LocalAudioConfig, videoConfig?: LocalVideoConfig): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.initializeLocalStreams(audioConfig, videoConfig);\n}\n\nexport async function joinStage(token: string, options?: { targetParticipantId?: string }): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.joinStage(token, options);\n}\n\nexport async function leaveStage(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.leaveStage();\n}\n\nexport async function setStreamsPublished(published: boolean): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.setStreamsPublished(published);\n}\n\nexport async function swapCamera(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.swapCamera();\n}\n\nexport async function setMicrophoneMuted(muted: boolean): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.setMicrophoneMuted(muted);\n}\n\nexport async function requestPermissions(): Promise<PermissionStatusMap> {\n  return await ExpoRealtimeIvsBroadcastModule.requestPermissions();\n}\n\n// --- Event Emitter ---\nexport function addOnStageConnectionStateChangedListener(\n  listener: (event: StageConnectionStatePayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onStageConnectionStateChanged', listener);\n}\n\nexport function addOnPublishStateChangedListener(\n  listener: (event: PublishStatePayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onPublishStateChanged', listener);\n}\n\nexport function addOnStageErrorListener(\n  listener: (event: StageErrorPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onStageError', listener);\n}\n\nexport function addOnCameraSwappedListener(\n  listener: (event: CameraSwappedPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onCameraSwapped', listener);\n}\n\nexport function addOnCameraSwapErrorListener(\n  listener: (event: CameraSwapErrorPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onCameraSwapError', listener);\n}\n\nexport function addOnParticipantJoinedListener(\n  listener: (event: ParticipantPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantJoined', listener);\n}\n\nexport function addOnParticipantLeftListener(\n  listener: (event: ParticipantPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantLeft', listener);\n}\n\nexport function addOnParticipantStreamsAddedListener(\n  listener: (event: ParticipantStreamsPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantStreamsAdded', listener);\n}\n\nexport function addOnParticipantStreamsRemovedListener(\n  listener: (event: ParticipantStreamsRemovedPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onParticipantStreamsRemoved', listener);\n}\n\n// --- Picture-in-Picture Methods ---\n\n/**\n * Enable Picture-in-Picture mode with the given options.\n * \n * @param options Configuration options for PiP behavior\n * @returns Promise resolving to true if PiP was enabled successfully\n * \n * @platform iOS 15.0+, Android 8.0+ (API 26+)\n * \n * @remarks\n * - iOS: Requires `UIBackgroundModes` with `audio` in Info.plist for background playback\n * - Android: The consuming app must add `android:supportsPictureInPicture=\"true\"` to their Activity\n */\nexport async function enablePictureInPicture(options?: PiPOptions): Promise<boolean> {\n  return await ExpoRealtimeIvsBroadcastModule.enablePictureInPicture(options);\n}\n\n/**\n * Disable Picture-in-Picture mode and clean up resources.\n */\nexport async function disablePictureInPicture(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.disablePictureInPicture();\n}\n\n/**\n * Manually start Picture-in-Picture mode.\n * PiP must be enabled first via `enablePictureInPicture()`.\n */\nexport async function startPictureInPicture(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.startPictureInPicture();\n}\n\n/**\n * Stop Picture-in-Picture mode and return to full screen.\n * \n * @remarks\n * On Android, this is a hint to the system - PiP is typically exited by user interaction.\n */\nexport async function stopPictureInPicture(): Promise<void> {\n  return await ExpoRealtimeIvsBroadcastModule.stopPictureInPicture();\n}\n\n/**\n * Check if Picture-in-Picture is currently active.\n * \n * @returns Promise resolving to true if PiP is currently active\n */\nexport async function isPictureInPictureActive(): Promise<boolean> {\n  return await ExpoRealtimeIvsBroadcastModule.isPictureInPictureActive();\n}\n\n/**\n * Check if Picture-in-Picture is supported on this device.\n * \n * @returns Promise resolving to true if PiP is supported\n * \n * @remarks\n * - iOS: Requires iOS 15.0+\n * - Android: Requires Android 8.0+ (API 26+) and device/activity support\n */\nexport async function isPictureInPictureSupported(): Promise<boolean> {\n  return await ExpoRealtimeIvsBroadcastModule.isPictureInPictureSupported();\n}\n\n// --- PiP Event Listeners ---\n\n/**\n * Add a listener for PiP state changes.\n * \n * @param listener Callback function receiving state: 'started' | 'stopped' | 'restored'\n * @returns EventSubscription to remove the listener\n */\nexport function addOnPiPStateChangedListener(\n  listener: (event: PiPStateChangedPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onPiPStateChanged', listener);\n}\n\n/**\n * Add a listener for PiP errors.\n * \n * @param listener Callback function receiving error message\n * @returns EventSubscription to remove the listener\n */\nexport function addOnPiPErrorListener(\n  listener: (event: PiPErrorPayload) => void\n): EventSubscription {\n  return ExpoRealtimeIvsBroadcastModule.addListener('onPiPError', listener);\n}\n"]}

package/ios/ExpoIVSRemoteStreamView.swift

@@ -15,6 +15,17 @@ class ExpoIVSRemoteStreamView: ExpoView {
     var scaleMode: String = "fill" {
         didSet { updateScaleMode() }
     }
+    
+    /// Returns the actual IVS preview view for PiP capture
+    /// This is the view that actually displays the video content
+    public var previewViewForPiP: UIView? {
+        return ivsImagePreviewView
+    }
+    
+    /// Returns whether this view is currently rendering video
+    public var isRenderingVideo: Bool {
+        return ivsImagePreviewView != nil && currentRenderedDeviceUrn != nil
+    }
 
     // MARK: - Initializers
 
@@ -90,6 +101,12 @@ class ExpoIVSRemoteStreamView: ExpoView {
 
             updateScaleMode()
             print("✅ [REMOTE VIEW] Manager commanded me to render URN: \(deviceUrn)")
+            
+            // Notify the stage manager that a stream started rendering (for PiP)
+            // Use a small delay to ensure the view is fully set up
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
+                self?.stageManager?.notifyRemoteStreamRendered()
+            }
         } catch {
             print("❌ [REMOTE VIEW] Failed to create preview for URN \(deviceUrn): \(error)")
         }

package/ios/ExpoIVSStagePreviewView.swift

@@ -42,6 +42,11 @@ class ExpoIVSStagePreviewView: ExpoView {
     required init?(coder: NSCoder) {
         fatalError("init(coder:) has not been implemented")
     }
+    
+    deinit {
+        // Unregister from PiP when view is deallocated
+        stageManager?.registerLocalPreviewView(nil)
+    }
 
     private func resolveStageManagerAndStream() {
         guard let moduleRegistry = appContext?.moduleRegistry else {
@@ -107,6 +112,9 @@ class ExpoIVSStagePreviewView: ExpoView {
         updateCustomPreviewMirror()
         
         print("ExpoIVSStagePreviewView: ✅ Custom preview layer attached, frame: \(bounds)")
+        
+        // Register this view with the stage manager for PiP support
+        registerForPiP()
     }
     
     private func attachNativePreview() {
@@ -158,6 +166,9 @@ class ExpoIVSStagePreviewView: ExpoView {
             updateScaleMode()
 
             print("ExpoIVSStagePreviewView: ✅ Native IVS preview attached for \(newDeviceUrn)")
+            
+            // Register this view with the stage manager for PiP support
+            registerForPiP()
 
         } catch {
             print("ExpoIVSStagePreviewView: Failed to create IVSImagePreviewView: \(error)")
@@ -212,6 +223,13 @@ class ExpoIVSStagePreviewView: ExpoView {
         attachStream()
     }
     
+    /// Register this view with the stage manager for PiP (Picture-in-Picture) support
+    private func registerForPiP() {
+        // Use self as the source view since this is the container that shows the video
+        stageManager?.registerLocalPreviewView(self)
+        print("ExpoIVSStagePreviewView: Registered for PiP support")
+    }
+    
     override func layoutSubviews() {
         super.layoutSubviews()
         // Update custom preview layer frame when view resizes

package/ios/ExpoRealtimeIvsBroadcast.podspec

@@ -25,5 +25,6 @@ Pod::Spec.new do |s|
     'DEFINES_MODULE' => 'YES',
   }
 
-  s.source_files = "ExpoRealtimeIvsBroadcastModule.swift", "IVSStageManager.swift", "ExpoIVSStagePreviewView.swift", "ExpoIVSRemoteStreamView.swift"
+  # Include all Swift files in the ios directory
+  s.source_files = "**/*.swift"
 end

package/ios/ExpoRealtimeIvsBroadcastModule.swift

@@ -1,5 +1,6 @@
 import ExpoModulesCore
 import AVFoundation // For permissions
+import AVKit // For PiP
 import AmazonIVSBroadcast // For config types if passed directly
 
 public class ExpoRealtimeIvsBroadcastModule: Module, IVSStageManagerDelegate {
@@ -15,7 +16,7 @@ public class ExpoRealtimeIvsBroadcastModule: Module, IVSStageManagerDelegate {
     // The module will be accessible from `requireNativeModule('ExpoRealtimeIvsBroadcast')` in JavaScript.
     Name("ExpoRealtimeIvsBroadcast")
     // Defines event names that the module can send to JavaScript.
-    Events("onStageConnectionStateChanged", "onPublishStateChanged", "onStageError", "onCameraSwapped", "onCameraSwapError", "onParticipantJoined", "onParticipantLeft", "onParticipantStreamsAdded", "onParticipantStreamsRemoved")
+    Events("onStageConnectionStateChanged", "onPublishStateChanged", "onStageError", "onCameraSwapped", "onCameraSwapError", "onParticipantJoined", "onParticipantLeft", "onParticipantStreamsAdded", "onParticipantStreamsRemoved", "onPiPStateChanged", "onPiPError")
 
     // Initialize the IVSStageManager when the module is created
     // and set self as its delegate.
@@ -78,6 +79,50 @@ public class ExpoRealtimeIvsBroadcastModule: Module, IVSStageManagerDelegate {
       }
     }
     
+    // MARK: - Picture-in-Picture Methods
+    
+    AsyncFunction("enablePictureInPicture") { (options: [String: Any]?) -> Bool in
+      if #available(iOS 15.0, *) {
+        self.ivsStageManager?.enablePictureInPicture(options: options)
+        return true
+      } else {
+        print("PiP requires iOS 15.0 or later")
+        return false
+      }
+    }
+    
+    AsyncFunction("disablePictureInPicture") { () -> Void in
+      if #available(iOS 15.0, *) {
+        self.ivsStageManager?.disablePictureInPicture()
+      }
+    }
+    
+    AsyncFunction("startPictureInPicture") { () -> Void in
+      if #available(iOS 15.0, *) {
+        self.ivsStageManager?.startPictureInPicture()
+      }
+    }
+    
+    AsyncFunction("stopPictureInPicture") { () -> Void in
+      if #available(iOS 15.0, *) {
+        self.ivsStageManager?.stopPictureInPicture()
+      }
+    }
+    
+    AsyncFunction("isPictureInPictureActive") { () -> Bool in
+      if #available(iOS 15.0, *) {
+        return self.ivsStageManager?.isPictureInPictureActive() ?? false
+      }
+      return false
+    }
+    
+    AsyncFunction("isPictureInPictureSupported") { () -> Bool in
+      if #available(iOS 15.0, *) {
+        return AVPictureInPictureController.isPictureInPictureSupported()
+      }
+      return false
+    }
+    
     View(ExpoIVSStagePreviewView.self) {
       Prop("mirror") { (view: ExpoIVSStagePreviewView, mirror: Bool) in
         print("DEBUG: Setting stage preview mirror to \(mirror)")