bitmovin-player-react-native 0.3.0 → 0.4.0

package/lib/index.js

@@ -31,6 +31,9 @@ var __publicField = (obj, key, value) => {
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  AdQuartile: () => AdQuartile,
+  AdSourceType: () => AdSourceType,
+  AudioSession: () => AudioSession,
   Drm: () => Drm,
   LoadingState: () => LoadingState,
   Player: () => Player,
@@ -42,18 +45,43 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/advertising.ts
+var AdQuartile = /* @__PURE__ */ ((AdQuartile2) => {
+  AdQuartile2["FIRST"] = "first";
+  AdQuartile2["MID_POINT"] = "mid_point";
+  AdQuartile2["THIRD"] = "third";
+  return AdQuartile2;
+})(AdQuartile || {});
+var AdSourceType = /* @__PURE__ */ ((AdSourceType2) => {
+  AdSourceType2["IMA"] = "ima";
+  AdSourceType2["UNKNOWN"] = "unknown";
+  AdSourceType2["PROGRESSIVE"] = "progressive";
+  return AdSourceType2;
+})(AdSourceType || {});
+
+// src/audioSession.ts
+var import_react_native = require("react-native");
+var AudioSessionModule = import_react_native.NativeModules.AudioSessionModule;
+var AudioSession = {
+  setCategory: async (category) => {
+    if (AudioSessionModule) {
+      await AudioSessionModule.setCategory(category);
+    }
+  }
+};
+
 // src/components/PlayerView/index.tsx
 var import_react2 = __toESM(require("react"));
-var import_react_native3 = require("react-native");
+var import_react_native4 = require("react-native");
 
 // src/components/PlayerView/native.ts
-var import_react_native = require("react-native");
-var NativePlayerView = (0, import_react_native.requireNativeComponent)("NativePlayerView");
+var import_react_native2 = require("react-native");
+var NativePlayerView = (0, import_react_native2.requireNativeComponent)("NativePlayerView");
 
 // src/hooks/useProxy.ts
 var import_lodash = __toESM(require("lodash.omit"));
 var import_react = require("react");
-var import_react_native2 = require("react-native");
+var import_react_native3 = require("react-native");
 function unwrapNativeEvent(event) {
   return (0, import_lodash.default)(event.nativeEvent, ["target"]);
 }
@@ -61,7 +89,7 @@ function useProxy(viewRef) {
   return (0, import_react.useCallback)(
     (callback) => (event) => {
       const node = event.target._nativeTag;
-      if (node === (0, import_react_native2.findNodeHandle)(viewRef.current)) {
+      if (node === (0, import_react_native3.findNodeHandle)(viewRef.current)) {
         callback?.(unwrapNativeEvent(event));
       }
     },
@@ -70,38 +98,55 @@ function useProxy(viewRef) {
 }
 
 // src/components/PlayerView/index.tsx
-var styles = import_react_native3.StyleSheet.create({
+var styles = import_react_native4.StyleSheet.create({
   baseStyle: {
     alignSelf: "stretch"
   }
 });
-function dispatch(command, node, playerId) {
-  const commandId = import_react_native3.Platform.OS === "android" ? import_react_native3.UIManager.NativePlayerView.Commands[command].toString() : import_react_native3.UIManager.getViewManagerConfig("NativePlayerView").Commands[command];
-  import_react_native3.UIManager.dispatchViewManagerCommand(
+function dispatch(command, node, ...args) {
+  const commandId = import_react_native4.Platform.OS === "android" ? import_react_native4.UIManager.NativePlayerView.Commands[command].toString() : import_react_native4.UIManager.getViewManagerConfig("NativePlayerView").Commands[command];
+  import_react_native4.UIManager.dispatchViewManagerCommand(
     node,
     commandId,
-    import_react_native3.Platform.select({
-      ios: [playerId],
-      android: [node, playerId]
-    })
+    import_react_native4.Platform.select({ ios: args, android: [node, ...args] })
   );
 }
-function PlayerView(props) {
+function PlayerView({ style, player, ...props }) {
   const nativeView = (0, import_react2.useRef)(null);
   const proxy = useProxy(nativeView);
-  const style = import_react_native3.StyleSheet.flatten([styles.baseStyle, props.style]);
+  const nativeViewStyle = import_react_native4.StyleSheet.flatten([styles.baseStyle, style]);
   (0, import_react2.useEffect)(() => {
-    props.player.initialize();
-    const node = (0, import_react_native3.findNodeHandle)(nativeView.current);
-    dispatch("attachPlayer", node, props.player.nativeId);
-  }, [props.player]);
+    player.initialize();
+    const node = (0, import_react_native4.findNodeHandle)(nativeView.current);
+    if (node) {
+      dispatch("attachPlayer", node, player.nativeId, player.config);
+    }
+  }, [player]);
   return /* @__PURE__ */ import_react2.default.createElement(NativePlayerView, {
     ref: nativeView,
-    style,
+    style: nativeViewStyle,
+    onAdBreakFinished: proxy(props.onAdBreakFinished),
+    onAdBreakStarted: proxy(props.onAdBreakStarted),
+    onAdClicked: proxy(props.onAdClicked),
+    onAdError: proxy(props.onAdError),
+    onAdFinished: proxy(props.onAdFinished),
+    onAdManifestLoad: proxy(props.onAdManifestLoad),
+    onAdManifestLoaded: proxy(props.onAdManifestLoaded),
+    onAdQuartile: proxy(props.onAdQuartile),
+    onAdScheduled: proxy(props.onAdScheduled),
+    onAdSkipped: proxy(props.onAdSkipped),
+    onAdStarted: proxy(props.onAdStarted),
     onDestroy: proxy(props.onDestroy),
     onEvent: proxy(props.onEvent),
     onMuted: proxy(props.onMuted),
     onPaused: proxy(props.onPaused),
+    onPictureInPictureAvailabilityChanged: proxy(
+      props.onPictureInPictureAvailabilityChanged
+    ),
+    onPictureInPictureEnter: proxy(props.onPictureInPictureEnter),
+    onPictureInPictureEntered: proxy(props.onPictureInPictureEntered),
+    onPictureInPictureExit: proxy(props.onPictureInPictureExit),
+    onPictureInPictureExited: proxy(props.onPictureInPictureExited),
     onPlay: proxy(props.onPlay),
     onPlaybackFinished: proxy(props.onPlaybackFinished),
     onPlayerActive: proxy(props.onPlayerActive),
@@ -111,6 +156,8 @@ function PlayerView(props) {
     onReady: proxy(props.onReady),
     onSeek: proxy(props.onSeek),
     onSeeked: proxy(props.onSeeked),
+    onStallStarted: proxy(props.onStallStarted),
+    onStallEnded: proxy(props.onStallEnded),
     onSourceError: proxy(props.onSourceError),
     onSourceLoad: proxy(props.onSourceLoad),
     onSourceLoaded: proxy(props.onSourceLoaded),
@@ -125,12 +172,12 @@ function PlayerView(props) {
 }
 
 // src/drm/index.ts
-var import_react_native5 = require("react-native");
+var import_react_native6 = require("react-native");
 var import_BatchedBridge = __toESM(require("react-native/Libraries/BatchedBridge/BatchedBridge"));
 
 // src/nativeInstance.ts
-var import_react_native4 = require("react-native");
-var Uuid = import_react_native4.NativeModules.UuidModule;
+var import_react_native5 = require("react-native");
+var Uuid = import_react_native5.NativeModules.UuidModule;
 var NativeInstance = class {
   constructor(config) {
     __publicField(this, "nativeId");
@@ -141,7 +188,7 @@ var NativeInstance = class {
 };
 
 // src/drm/index.ts
-var DrmModule = import_react_native5.NativeModules.DrmModule;
+var DrmModule = import_react_native6.NativeModules.DrmModule;
 var Drm = class extends NativeInstance {
   constructor() {
     super(...arguments);
@@ -169,11 +216,11 @@ var Drm = class extends NativeInstance {
       }
     });
     __publicField(this, "onPrepareMessage", (message, assetId) => {
-      const config = import_react_native5.Platform.OS === "ios" ? this.config?.fairplay : this.config?.widevine;
+      const config = import_react_native6.Platform.OS === "ios" ? this.config?.fairplay : this.config?.widevine;
       if (config && config.prepareMessage) {
         DrmModule.setPreparedMessage(
           this.nativeId,
-          import_react_native5.Platform.OS === "ios" ? config.prepareMessage?.(message, assetId) : config.prepareMessage?.(message)
+          import_react_native6.Platform.OS === "ios" ? config.prepareMessage?.(message, assetId) : config.prepareMessage?.(message)
         );
       }
     });
@@ -186,7 +233,7 @@ var Drm = class extends NativeInstance {
       }
     });
     __publicField(this, "onPrepareLicense", (license) => {
-      const prepareLicense = import_react_native5.Platform.OS === "ios" ? this.config?.fairplay?.prepareLicense : this.config?.widevine?.prepareLicense;
+      const prepareLicense = import_react_native6.Platform.OS === "ios" ? this.config?.fairplay?.prepareLicense : this.config?.widevine?.prepareLicense;
       if (prepareLicense) {
         DrmModule.setPreparedLicense(this.nativeId, prepareLicense(license));
       }
@@ -214,11 +261,11 @@ var Drm = class extends NativeInstance {
 var import_react3 = require("react");
 
 // src/player.ts
-var import_react_native7 = require("react-native");
+var import_react_native8 = require("react-native");
 
 // src/source.ts
-var import_react_native6 = require("react-native");
-var SourceModule = import_react_native6.NativeModules.SourceModule;
+var import_react_native7 = require("react-native");
+var SourceModule = import_react_native7.NativeModules.SourceModule;
 var SourceType = /* @__PURE__ */ ((SourceType2) => {
   SourceType2["NONE"] = "none";
   SourceType2["HLS"] = "hls";
@@ -283,7 +330,7 @@ var Source = class extends NativeInstance {
 };
 
 // src/player.ts
-var PlayerModule = import_react_native7.NativeModules.PlayerModule;
+var PlayerModule = import_react_native8.NativeModules.PlayerModule;
 var Player = class extends NativeInstance {
   constructor() {
     super(...arguments);
@@ -354,7 +401,7 @@ var Player = class extends NativeInstance {
       return PlayerModule.isLive(this.nativeId);
     });
     __publicField(this, "isAirPlayActive", async () => {
-      if (import_react_native7.Platform.OS === "android") {
+      if (import_react_native8.Platform.OS === "android") {
         console.warn(
           `[Player ${this.nativeId}] Method isAirPlayActive is not available for Android. Only iOS devices.`
         );
@@ -363,7 +410,7 @@ var Player = class extends NativeInstance {
       return PlayerModule.isAirPlayActive(this.nativeId);
     });
     __publicField(this, "isAirPlayAvailable", async () => {
-      if (import_react_native7.Platform.OS === "android") {
+      if (import_react_native8.Platform.OS === "android") {
         console.warn(
           `[Player ${this.nativeId}] Method isAirPlayAvailable is not available for Android. Only iOS devices.`
         );
@@ -374,6 +421,15 @@ var Player = class extends NativeInstance {
     __publicField(this, "getAvailableSubtitles", async () => {
       return PlayerModule.getAvailableSubtitles(this.nativeId);
     });
+    __publicField(this, "scheduleAd", (adItem) => {
+      PlayerModule.scheduleAd(this.nativeId, adItem);
+    });
+    __publicField(this, "skipAd", () => {
+      PlayerModule.skipAd(this.nativeId);
+    });
+    __publicField(this, "isAd", () => {
+      return PlayerModule.isAd(this.nativeId);
+    });
   }
 };
 
@@ -391,6 +447,9 @@ var SubtitleFormat = /* @__PURE__ */ ((SubtitleFormat2) => {
 })(SubtitleFormat || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AdQuartile,
+  AdSourceType,
+  AudioSession,
   Drm,
   LoadingState,
   Player,

package/lib/index.mjs

@@ -5,6 +5,31 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 
+// src/advertising.ts
+var AdQuartile = /* @__PURE__ */ ((AdQuartile2) => {
+  AdQuartile2["FIRST"] = "first";
+  AdQuartile2["MID_POINT"] = "mid_point";
+  AdQuartile2["THIRD"] = "third";
+  return AdQuartile2;
+})(AdQuartile || {});
+var AdSourceType = /* @__PURE__ */ ((AdSourceType2) => {
+  AdSourceType2["IMA"] = "ima";
+  AdSourceType2["UNKNOWN"] = "unknown";
+  AdSourceType2["PROGRESSIVE"] = "progressive";
+  return AdSourceType2;
+})(AdSourceType || {});
+
+// src/audioSession.ts
+import { NativeModules } from "react-native";
+var AudioSessionModule = NativeModules.AudioSessionModule;
+var AudioSession = {
+  setCategory: async (category) => {
+    if (AudioSessionModule) {
+      await AudioSessionModule.setCategory(category);
+    }
+  }
+};
+
 // src/components/PlayerView/index.tsx
 import React, { useRef, useEffect } from "react";
 import {
@@ -43,33 +68,50 @@ var styles = StyleSheet.create({
     alignSelf: "stretch"
   }
 });
-function dispatch(command, node, playerId) {
+function dispatch(command, node, ...args) {
   const commandId = Platform.OS === "android" ? UIManager.NativePlayerView.Commands[command].toString() : UIManager.getViewManagerConfig("NativePlayerView").Commands[command];
   UIManager.dispatchViewManagerCommand(
     node,
     commandId,
-    Platform.select({
-      ios: [playerId],
-      android: [node, playerId]
-    })
+    Platform.select({ ios: args, android: [node, ...args] })
   );
 }
-function PlayerView(props) {
+function PlayerView({ style, player, ...props }) {
   const nativeView = useRef(null);
   const proxy = useProxy(nativeView);
-  const style = StyleSheet.flatten([styles.baseStyle, props.style]);
+  const nativeViewStyle = StyleSheet.flatten([styles.baseStyle, style]);
   useEffect(() => {
-    props.player.initialize();
+    player.initialize();
     const node = findNodeHandle2(nativeView.current);
-    dispatch("attachPlayer", node, props.player.nativeId);
-  }, [props.player]);
+    if (node) {
+      dispatch("attachPlayer", node, player.nativeId, player.config);
+    }
+  }, [player]);
   return /* @__PURE__ */ React.createElement(NativePlayerView, {
     ref: nativeView,
-    style,
+    style: nativeViewStyle,
+    onAdBreakFinished: proxy(props.onAdBreakFinished),
+    onAdBreakStarted: proxy(props.onAdBreakStarted),
+    onAdClicked: proxy(props.onAdClicked),
+    onAdError: proxy(props.onAdError),
+    onAdFinished: proxy(props.onAdFinished),
+    onAdManifestLoad: proxy(props.onAdManifestLoad),
+    onAdManifestLoaded: proxy(props.onAdManifestLoaded),
+    onAdQuartile: proxy(props.onAdQuartile),
+    onAdScheduled: proxy(props.onAdScheduled),
+    onAdSkipped: proxy(props.onAdSkipped),
+    onAdStarted: proxy(props.onAdStarted),
     onDestroy: proxy(props.onDestroy),
     onEvent: proxy(props.onEvent),
     onMuted: proxy(props.onMuted),
     onPaused: proxy(props.onPaused),
+    onPictureInPictureAvailabilityChanged: proxy(
+      props.onPictureInPictureAvailabilityChanged
+    ),
+    onPictureInPictureEnter: proxy(props.onPictureInPictureEnter),
+    onPictureInPictureEntered: proxy(props.onPictureInPictureEntered),
+    onPictureInPictureExit: proxy(props.onPictureInPictureExit),
+    onPictureInPictureExited: proxy(props.onPictureInPictureExited),
     onPlay: proxy(props.onPlay),
     onPlaybackFinished: proxy(props.onPlaybackFinished),
     onPlayerActive: proxy(props.onPlayerActive),
@@ -79,6 +121,8 @@ function PlayerView(props) {
     onReady: proxy(props.onReady),
     onSeek: proxy(props.onSeek),
     onSeeked: proxy(props.onSeeked),
+    onStallStarted: proxy(props.onStallStarted),
+    onStallEnded: proxy(props.onStallEnded),
     onSourceError: proxy(props.onSourceError),
     onSourceLoad: proxy(props.onSourceLoad),
     onSourceLoaded: proxy(props.onSourceLoaded),
@@ -93,12 +137,12 @@ function PlayerView(props) {
 }
 
 // src/drm/index.ts
-import { NativeModules as NativeModules2, Platform as Platform2 } from "react-native";
+import { NativeModules as NativeModules3, Platform as Platform2 } from "react-native";
 import BatchedBridge from "react-native/Libraries/BatchedBridge/BatchedBridge";
 
 // src/nativeInstance.ts
-import { NativeModules } from "react-native";
-var Uuid = NativeModules.UuidModule;
+import { NativeModules as NativeModules2 } from "react-native";
+var Uuid = NativeModules2.UuidModule;
 var NativeInstance = class {
   constructor(config) {
     __publicField(this, "nativeId");
@@ -109,7 +153,7 @@ var NativeInstance = class {
 };
 
 // src/drm/index.ts
-var DrmModule = NativeModules2.DrmModule;
+var DrmModule = NativeModules3.DrmModule;
 var Drm = class extends NativeInstance {
   constructor() {
     super(...arguments);
@@ -182,11 +226,11 @@ var Drm = class extends NativeInstance {
 import { useRef as useRef2 } from "react";
 
 // src/player.ts
-import { NativeModules as NativeModules4, Platform as Platform3 } from "react-native";
+import { NativeModules as NativeModules5, Platform as Platform3 } from "react-native";
 
 // src/source.ts
-import { NativeModules as NativeModules3 } from "react-native";
-var SourceModule = NativeModules3.SourceModule;
+import { NativeModules as NativeModules4 } from "react-native";
+var SourceModule = NativeModules4.SourceModule;
 var SourceType = /* @__PURE__ */ ((SourceType2) => {
   SourceType2["NONE"] = "none";
   SourceType2["HLS"] = "hls";
@@ -251,7 +295,7 @@ var Source = class extends NativeInstance {
 };
 
 // src/player.ts
-var PlayerModule = NativeModules4.PlayerModule;
+var PlayerModule = NativeModules5.PlayerModule;
 var Player = class extends NativeInstance {
   constructor() {
     super(...arguments);
@@ -342,6 +386,15 @@ var Player = class extends NativeInstance {
     __publicField(this, "getAvailableSubtitles", async () => {
       return PlayerModule.getAvailableSubtitles(this.nativeId);
     });
+    __publicField(this, "scheduleAd", (adItem) => {
+      PlayerModule.scheduleAd(this.nativeId, adItem);
+    });
+    __publicField(this, "skipAd", () => {
+      PlayerModule.skipAd(this.nativeId);
+    });
+    __publicField(this, "isAd", () => {
+      return PlayerModule.isAd(this.nativeId);
+    });
   }
 };
 
@@ -358,6 +411,9 @@ var SubtitleFormat = /* @__PURE__ */ ((SubtitleFormat2) => {
   return SubtitleFormat2;
 })(SubtitleFormat || {});
 export {
+  AdQuartile,
+  AdSourceType,
+  AudioSession,
   Drm,
   LoadingState,
   Player,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitmovin-player-react-native",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official React Native bindings for Bitmovin's mobile Player SDKs.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",

package/src/advertising.ts

@@ -0,0 +1,155 @@
+/**
+ * Quartiles that can be reached during an ad playback.
+ */
+export enum AdQuartile {
+  FIRST = 'first',
+  MID_POINT = 'mid_point',
+  THIRD = 'third',
+}
+
+/**
+ * The possible types an `AdSource` can be.
+ */
+export enum AdSourceType {
+  IMA = 'ima',
+  UNKNOWN = 'unknown',
+  PROGRESSIVE = 'progressive',
+}
+
+/**
+ * Represents an ad source which can be assigned to an `AdItem`. An `AdItem` can have multiple `AdSource`s
+ * as waterfalling option.
+ */
+export interface AdSource {
+  /**
+   * The ad tag / url to the ad manifest.
+   */
+  tag: string;
+  /**
+   * The `AdSourceType` of this `AdSource`.
+   */
+  type: AdSourceType;
+}
+
+/**
+ * Represents an ad break which can be scheduled for playback.
+ *
+ * One single `AdItem` can have multiple `AdSource`s where all but the first act as fallback ad sources
+ * if the first one fails to load. The start and end of an ad break are signaled via `AdBreakStartedEvent`
+ * and `AdBreakFinishedEvent`.
+ */
+export interface AdItem {
+  /**
+   * The playback position at which the ad break is scheduled to start. Default value is "pre".
+   *
+   * Possible values are:
+   *  • "pre": pre-roll ad (for VoD and Live streaming)
+   *  • "post": post-roll ad (for VoD streaming only)
+   *  • fractional seconds: "10", "12.5" (mid-roll ad, for VoD and Live streaming)
+   *  • percentage of the entire video duration: "25%", "50%" (mid-roll ad, for VoD streaming only)
+   *  • timecode hh:mm:ss.mmm: "00:10:30.000", "01:00:00.000" (mid-roll ad, for VoD streaming only)
+   */
+  position?: string;
+  /**
+   * The `AdSource`s that make up this `AdItem`. The first ad source in this array is used as the main ad.
+   * Subsequent ad sources act as a fallback, meaning that if the main ad source does not provide a
+   * valid response, the subsequent ad sources will be utilized one after another.
+   *
+   * The fallback ad sources need to have the same `AdSourceType` as the main ad source.
+   */
+  sources: AdSource[];
+}
+
+/**
+ * Contains configuration values regarding the ads which should be played back by the player.
+ */
+export interface AdvertisingConfig {
+  /**
+   * The ad items that are scheduled when a new playback session is started via `Player.load()`.
+   */
+  schedule: AdItem[];
+}
+
+/**
+ * Contains the base configuration options for an ad.
+ */
+export interface AdConfig {
+  /**
+   * Specifies how many seconds of the main video content should be replaced by ad break(s).
+   */
+  replaceContentDuration: number;
+}
+
+/**
+ * Holds various additional ad data.
+ */
+export interface AdData {
+  /**
+   * The average bitrate of the progressive media file as defined in the VAST response.
+   */
+  bitrate?: number;
+  /**
+   * The maximum bitrate of the streaming media file as defined in the VAST response.
+   */
+  maxBitrate?: number;
+  /**
+   * The MIME type of the media file or creative as defined in the VAST response.
+   */
+  mimeType?: string;
+  /**
+   * The minimum bitrate of the streaming media file as defined in the VAST response.
+   */
+  minBitrate?: number;
+}
+
+/**
+ * Defines basic properties available for every ad type.
+ */
+export interface Ad {
+  /**
+   * The url the user should be redirected to when clicking the ad.
+   */
+  clickThroughUrl?: string;
+  /**
+   * Holds various additional `AdData`.
+   */
+  data?: AdData;
+  /**
+   * The height of the ad.
+   */
+  height: number;
+  /**
+   * Identifier for the ad. This might be autogenerated.
+   */
+  id?: string;
+  /**
+   * Determines whether an ad is linear, i.e. playback of main content needs to be paused for the ad.
+   */
+  isLinear: boolean;
+  /**
+   * The corresponding media file url for the ad.
+   */
+  mediaFileUrl?: string;
+  /**
+   * The width of the ad.
+   */
+  width: number;
+}
+
+/**
+ * Contains information about an ad break.
+ */
+export interface AdBreak {
+  /**
+   * The ads scheduled for this `AdBreak`.
+   */
+  ads: Ad[];
+  /**
+   * The id of the corresponding `AdBreakConfig`. This will be auto-generated.
+   */
+  id: string;
+  /**
+   * The time in seconds in the media timeline the `AdBreak` is scheduled for.
+   */
+  scheduleTime: number;
+}

package/src/audioSession.ts

@@ -0,0 +1,47 @@
+import { NativeModules } from 'react-native';
+
+const AudioSessionModule = NativeModules.AudioSessionModule;
+
+/**
+ * An audio session category defines a set of audio behaviors.
+ * Choose a category that most accurately describes the audio behavior you require.
+ *
+ * Note the `playback` category is required in order to properly enable picture in picture support.
+ *
+ * - `ambient`: The category for an app in which sound playback is nonprimary — that is, your app also works with the sound turned off.
+ * - `multiRoute`: The category for routing distinct streams of audio data to different output devices at the same time.
+ * - `playAndRecord`: The category for recording (input) and playback (output) of audio, such as for a Voice over Internet Protocol (VoIP) app.
+ * - `playback`: The category for playing recorded music or other sounds that are central to the successful use of your app.
+ * - `record`: The category for recording audio while also silencing playback audio.
+ * - `soloAmbient`: The default audio session category.
+ *
+ * @platform iOS
+ * @see https://developer.apple.com/documentation/avfaudio/avaudiosession/category
+ */
+export type AudioSessionCategory =
+  | 'ambient'
+  | 'multiRoute'
+  | 'playAndRecord'
+  | 'playback'
+  | 'record'
+  | 'soloAmbient';
+
+/**
+ * An object that communicates to the system how you intend to use audio in your app.
+ *
+ * @platform iOS
+ * @see https://developer.apple.com/documentation/avfaudio/avaudiosession
+ */
+export const AudioSession = {
+  /**
+   * Sets the audio session's category.
+   *
+   * @platform iOS
+   * @see https://developer.apple.com/documentation/avfaudio/avaudiosession/1616583-setcategory
+   */
+  setCategory: async (category: AudioSessionCategory): Promise<void> => {
+    if (AudioSessionModule) {
+      await AudioSessionModule.setCategory(category);
+    }
+  },
+};