@ray-js/ray-ipc-player 2.1.1 → 2.1.2

package/README.md

@@ -48,6 +48,11 @@ export type IProps = {
    * @default (playerRef) => void
    */
   onCtx?: (playerRef) => void;
+  /**
+   * @description.en Fired when the native view layer finishes initialization; ipcCtx APIs can be safely called after this
+   * @default undefined
+   */
+  onInitDone?: () => void;
   /**
    * @description.en The initialization preview is successful
    * @default (devId) => void
@@ -99,7 +104,7 @@ export type IProps = {
    * @description.zh contain: The long side of the image will fill the screen, the short side area will be filled with black, fillCrop: The image will fill the screen
    * @default "contain"
    */
-   objectFit?: string;
+  objectFit?: string;
   /**
    * @description.en Extended Attributes
    * @default {}

package/lib/hooks/usePlayerProps.js

@@ -12,6 +12,7 @@ export const usePlayerProps = props => {
     onCameraPreviewFailure,
     onCameraNotifyWeakNetwork,
     onInitPreview,
+    onInitDone,
     defaultMute = true,
     onlineStatus = true,
     loadText = '',
@@ -104,6 +105,7 @@ export const usePlayerProps = props => {
     onCameraPreviewFailure,
     onCameraNotifyWeakNetwork,
     onInitPreview,
+    onInitDone,
     onCtx,
     renderErrIcon,
     onPlayerContainerTap,

package/lib/index.js

@@ -30,6 +30,7 @@ const Player = props => {
     onCameraPreviewFailure,
     onCameraNotifyWeakNetwork,
     onInitPreview,
+    onInitDone: onInitDoneCallback,
     defaultMute,
     onlineStatus,
     loadText,
@@ -616,6 +617,15 @@ const Player = props => {
   }, [phoneNetworkConnect, onlineStatus, playState.initLy, privateState, limitFlow, previewOn, isPreviewControlled, previewEnabled, runPullStream, retry]);
 
   // 视图层准备就绪，开始建立连接
+  const initDone = useMemoizedFn(() => {
+    console.log('视图层准备就绪~');
+    ipcTTTOperatorLog('VID: player_initDone_event_finish');
+    setPlayState(d => {
+      d.updateLy = Math.random();
+      d.initLy = true;
+    });
+    onInitDoneCallback === null || onInitDoneCallback === void 0 || onInitDoneCallback();
+  });
 
   /**
    * 获取当前是否静音
@@ -739,14 +749,7 @@ const Player = props => {
     onZoomChange: onZoomChange,
     onCameraPreviewFailure: handleCameraPreviewFailure,
     onCameraNotifyWeakNetwork: onCameraNotifyWeakNetwork,
-    onInitDone: () => {
-      console.log('视图层准备就绪~');
-      ipcTTTOperatorLog('VID: player_initDone_event_finish');
-      setPlayState(d => {
-        d.updateLy = Math.random();
-        d.initLy = true;
-      });
-    },
+    onInitDone: initDone,
     onError: onError,
     onConnectChange: connectChange,
     deviceId: devId,

package/lib/typings/index.d.ts

@@ -106,6 +106,12 @@ export type IProps = {
     retry: () => void;
     setPreviewEnabled: (enabled: boolean) => void;
   }) => void;
+  /**
+   * @description.en onInitDone
+   * @description.zh 视图层初始化完成通知，此后可安全调用 ipcCtx 相关 API
+   * @default undefined
+   */
+  onInitDone?: () => void;
   /**
    * @description.en onInitPreview
    * @description.zh 初始化预览成功通知

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/ray-ipc-player",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "ray小程序播放器",
   "keywords": [
     "tuya-miniapp",