@xmaxai/web-sdk 1.0.3 → 1.0.4

package/dist/index.cjs

@@ -26,8 +26,8 @@
 
 
 
-var _chunkJWAAS6P4cjs = require('./chunk-JWAAS6P4.cjs');
 
+var _chunkFEL5MJMJcjs = require('./chunk-FEL5MJMJ.cjs');
 
 
 
@@ -55,5 +55,7 @@ var _chunkJWAAS6P4cjs = require('./chunk-JWAAS6P4.cjs');
 
 
 
-exports.CameraPosition = _chunkJWAAS6P4cjs.CameraPosition; exports.MediaService = _chunkJWAAS6P4cjs.MediaService; exports.RealtimeConfiguration = _chunkJWAAS6P4cjs.RealtimeConfiguration; exports.RealtimeConnectionState = _chunkJWAAS6P4cjs.RealtimeConnectionState; exports.RealtimeContext = _chunkJWAAS6P4cjs.RealtimeContext; exports.RealtimeMediaStream = _chunkJWAAS6P4cjs.RealtimeMediaStream; exports.RealtimeModel = _chunkJWAAS6P4cjs.RealtimeModel; exports.RealtimeReason = _chunkJWAAS6P4cjs.RealtimeReason; exports.RealtimeState = _chunkJWAAS6P4cjs.RealtimeState; exports.RealtimeVideoEncoderPreference = _chunkJWAAS6P4cjs.RealtimeVideoEncoderPreference; exports.RealtimeVideoFormat = _chunkJWAAS6P4cjs.RealtimeVideoFormat; exports.RealtimeVideoTrack = _chunkJWAAS6P4cjs.RealtimeVideoTrack; exports.StorageService = _chunkJWAAS6P4cjs.StorageService; exports.StoredFile = _chunkJWAAS6P4cjs.StoredFile; exports.VideoContentMode = _chunkJWAAS6P4cjs.VideoContentMode; exports.XmaxClient = _chunkJWAAS6P4cjs.XmaxClient; exports.XmaxConfiguration = _chunkJWAAS6P4cjs.XmaxConfiguration; exports.XmaxEnvironment = _chunkJWAAS6P4cjs.XmaxEnvironment; exports.XmaxError = _chunkJWAAS6P4cjs.XmaxError; exports.XmaxErrorCode = _chunkJWAAS6P4cjs.XmaxErrorCode; exports.XmaxLogger = _chunkJWAAS6P4cjs.XmaxLogger; exports.XmaxLoggerOption = _chunkJWAAS6P4cjs.XmaxLoggerOption; exports.XmaxRealtimeVideoView = _chunkJWAAS6P4cjs.XmaxRealtimeVideoView; exports.XmaxVideoView = _chunkJWAAS6P4cjs.XmaxVideoView; exports.apiBaseURL = _chunkJWAAS6P4cjs.apiBaseURL; exports.defaultCameraVideoFormat = _chunkJWAAS6P4cjs.defaultCameraVideoFormat; exports.defaultFrameRate = _chunkJWAAS6P4cjs.defaultFrameRate;
+
+
+exports.CameraPosition = _chunkFEL5MJMJcjs.CameraPosition; exports.MediaService = _chunkFEL5MJMJcjs.MediaService; exports.RealtimeConfiguration = _chunkFEL5MJMJcjs.RealtimeConfiguration; exports.RealtimeConnectionState = _chunkFEL5MJMJcjs.RealtimeConnectionState; exports.RealtimeContext = _chunkFEL5MJMJcjs.RealtimeContext; exports.RealtimeMediaStream = _chunkFEL5MJMJcjs.RealtimeMediaStream; exports.RealtimeModel = _chunkFEL5MJMJcjs.RealtimeModel; exports.RealtimeReason = _chunkFEL5MJMJcjs.RealtimeReason; exports.RealtimeState = _chunkFEL5MJMJcjs.RealtimeState; exports.RealtimeVideoEncoderPreference = _chunkFEL5MJMJcjs.RealtimeVideoEncoderPreference; exports.RealtimeVideoFormat = _chunkFEL5MJMJcjs.RealtimeVideoFormat; exports.RealtimeVideoTrack = _chunkFEL5MJMJcjs.RealtimeVideoTrack; exports.RtcProvider = _chunkFEL5MJMJcjs.RtcProvider; exports.StorageService = _chunkFEL5MJMJcjs.StorageService; exports.StoredFile = _chunkFEL5MJMJcjs.StoredFile; exports.VideoContentMode = _chunkFEL5MJMJcjs.VideoContentMode; exports.XmaxClient = _chunkFEL5MJMJcjs.XmaxClient; exports.XmaxConfiguration = _chunkFEL5MJMJcjs.XmaxConfiguration; exports.XmaxEnvironment = _chunkFEL5MJMJcjs.XmaxEnvironment; exports.XmaxError = _chunkFEL5MJMJcjs.XmaxError; exports.XmaxErrorCode = _chunkFEL5MJMJcjs.XmaxErrorCode; exports.XmaxLogger = _chunkFEL5MJMJcjs.XmaxLogger; exports.XmaxLoggerOption = _chunkFEL5MJMJcjs.XmaxLoggerOption; exports.XmaxRealtimeVideoView = _chunkFEL5MJMJcjs.XmaxRealtimeVideoView; exports.XmaxVideoView = _chunkFEL5MJMJcjs.XmaxVideoView; exports.apiBaseURL = _chunkFEL5MJMJcjs.apiBaseURL; exports.defaultCameraVideoFormat = _chunkFEL5MJMJcjs.defaultCameraVideoFormat; exports.defaultFrameRate = _chunkFEL5MJMJcjs.defaultFrameRate;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-weZCpU/source/packages/xmax-sdk/dist/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,spDAAC","file":"/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-weZCpU/source/packages/xmax-sdk/dist/index.cjs"}
+{"version":3,"sources":["/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-sdawVu/source/packages/xmax-sdk/dist/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,2sDAAC","file":"/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-sdawVu/source/packages/xmax-sdk/dist/index.cjs"}

package/dist/index.d.cts

@@ -10,13 +10,15 @@ declare enum RealtimeModel {
      */
     x2_0 = "x2.0",
     /**
-     * Xmax X2.0 Pro 实时生成模型。
+     * Xmax X2.0 TRTC 实时生成模型。
      */
-    x2_0_pro = "x2.0-pro",
+    x2_0_trtc = "x2.0-trtc",
     /**
-     * Xmax X2.0 TRTC 实时生成模型。
+     * Xmax X2.0 Agora 实时生成模型。
      */
-    x2_0_trtc = "x2.0-trtc"
+    x2_0_agora = "x2.0-agora",
+    /** X2.1 预览模型；媒体规格与 x2.0-trtc 相同。 */
+    x2_1_preview = "x2.1-preview"
 }
 interface ModelSize {
     width: number;
@@ -124,6 +126,22 @@ interface StorageServicing {
     uploadImage(options: StorageUploadOptions): Promise<StoredFile>;
 }
 
+/**
+ * 实时媒体使用的 RTC 提供方；一个 Manager 生命周期内保持不变。
+ */
+declare enum RtcProvider {
+    /**
+     * 腾讯实时音视频。
+     */
+    trtc = "trtc",
+    /**
+     * 声网实时音视频。
+     */
+    agora = "agora",
+    /** 火山引擎实时音视频。 */
+    vertc = "vertc"
+}
+
 /**
  * 远端视频插帧的开关与显示帧率配置。
  */
@@ -138,6 +156,10 @@ interface FrameInterpolationConfiguration {
     targetFrameRate?: number;
 }
 interface RealtimeConfigurationInit {
+    /**
+     * RTC 提供方，默认 TRTC；不根据模型名称自动推断。
+     */
+    provider?: RtcProvider;
     /**
      * 实时生成业务使用的模型。
      */
@@ -156,6 +178,10 @@ interface RealtimeConfigurationInit {
  * 创建实时 Manager 所需的业务配置。
  */
 declare class RealtimeConfiguration {
+    /**
+     * RTC 配置
+     */
+    readonly provider: RtcProvider;
     /**
      * 模型配置
      */
@@ -178,6 +204,7 @@ declare class RealtimeConfiguration {
      * 创建实时业务配置。
      *
      * @param init.model 实时生成业务使用的模型。
+     * @param init.provider RTC 提供方，默认 TRTC；创建后不可切换。
      * @param init.isFrameInterpolationEnabled 是否默认开启远端生成画面的插帧。
      * @param init.frameInterpolation 插帧开关和显示帧率上限的详细配置。
      */
@@ -185,7 +212,7 @@ declare class RealtimeConfiguration {
 }
 
 /**
- * TRTC 网络质量等级：未知、极好、良好、一般、差、极差、断网。
+ * RTC 网络质量等级：未知、极好、良好、一般、差、极差、断网。
  */
 type NetworkQualityLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /**
@@ -198,11 +225,11 @@ interface NetworkStatistics {
      */
     readonly downlinkQuality?: NetworkQualityLevel;
     /**
-     * 上行连接到 TRTC 云端的往返延迟，单位 ms，不是单程延迟。
+     * 上行连接到 RTC 云端的往返延迟，单位 ms，不是单程延迟；Agora 未提供时为空。
      */
     readonly uplinkRttMs?: number;
     /**
-     * 所有下行连接到 TRTC 云端的平均往返延迟，单位 ms。
+     * 所有下行连接到 RTC 云端的平均往返延迟，单位 ms；Agora 未提供时为空。
      */
     readonly downlinkRttMs?: number;
 }
@@ -534,6 +561,10 @@ type RealtimeLaunchTimingListener = (timing: RealtimeLaunchTiming) => void;
  * 视频流实际运行统计；缺失或无效指标为 undefined。
  */
 interface VideoStatistics {
+    /**
+     * 本端视频上行丢包率，单位 %；厂商未提供时为空。
+     */
+    readonly uplinkLossPercent?: number;
     readonly width?: number;
     readonly height?: number;
     /**
@@ -555,23 +586,24 @@ type VideoStatisticsListener = (statistics: VideoStatistics | undefined) => void
 interface RemoteVideoStatistics extends VideoStatistics {
     readonly userID: string;
     /**
-     * 本端 SDK 到 TRTC 云端的往返延迟，单位 ms；不是与远端用户之间的 RTT。
+     * 本端 SDK 到 RTC 云端的往返延迟，单位 ms；不是与远端用户之间的 RTT。
      */
     readonly rttMs?: number;
     /**
-     * 本端 SDK 到 TRTC 云端的上行丢包率，单位 %，不是结果流的发送端丢包率。
+     * 本端 SDK 到 RTC 云端的上行丢包率，单位 %，不是结果流的发送端丢包率。
      */
     readonly uplinkLossPercent?: number;
     /**
-     * TRTC 云端到本端 SDK 的下行丢包率，单位 %。
+     * RTC 云端到本端 SDK 的下行丢包率，单位 %。
      */
     readonly downlinkLossPercent?: number;
     /**
-     * 当前远端视频流的播放缓冲延迟，单位 ms。
+     * 当前远端视频流的播放缓冲延迟，单位 ms；Agora 未提供时为空。
      */
     readonly jitterBufferDelayMs?: number;
     /**
-     * TRTC 媒体端到端延迟估算值，单位 ms；不代表完整 AI 处理链路耗时。
+     * RTC 媒体端到端延迟估算值，单位 ms；不代表完整 AI 处理链路耗时。
+     * 采用各厂商原生口径，Agora end2EndDelay 不包含编码与解码耗时。
      */
     readonly endToEndDelayMs?: number;
 }
@@ -665,6 +697,17 @@ interface XmaxRealtimeManaging {
          */
         enableFrameValidation?: boolean;
     }): Promise<RealtimeMediaStream>;
+    /**
+     * 更新当前本地流的上行视频格式，立即应用于 RTC 编码器，不重连或重启生成。
+     * 传入完整格式；未指定的码率和编码偏好按 RealtimeVideoFormat 默认规则解析。
+     * 成功后更新本地轨道的 videoFormat，后续重连继续使用该格式。
+     * 模型生成及远端插帧仍使用创建本地流时的格式；此接口不改变生成尺寸。
+     * 实际发送规格受设备、浏览器和网络影响，应通过统计回调确认。
+     *
+     * @param videoFormat 本次完整的上行尺寸、帧率和编码配置。
+     * @throws 无本地相机流、其他操作进行中、参数无效或 RTC 更新失败时抛错。
+     */
+    updateVideoFormat(videoFormat: RealtimeVideoFormat): Promise<void>;
     /**
      * 停止本地相机流并释放本地预览与 RTC 资源。
      */
@@ -893,6 +936,7 @@ declare class XmaxClient {
     constructor(configuration: XmaxConfiguration);
     /**
      * 创建实时媒体 Manager。
+     * 模型专用地址优先于环境默认地址，并用于该 Manager 的整个会话生命周期。
      *
      * @param options 实时生成模型等业务配置。
      * @returns 可用于本地相机预览、实时连接与生成的实时 Manager。
@@ -1356,4 +1400,4 @@ declare class XmaxRealtimeVideoView {
     private showRemoteVideo;
 }
 
-export { CameraPosition, type FrameInterpolationConfiguration, MediaService, type MediaServicing, type NetworkQualityLevel, type NetworkStatistics, type NetworkStatisticsListener, RealtimeConfiguration, type RealtimeConfigurationInit, RealtimeConnectionState, RealtimeContext, type RealtimeContextInit, type RealtimeLaunchTiming, type RealtimeLaunchTimingListener, RealtimeMediaStream, RealtimeModel, RealtimeReason, RealtimeState, type RealtimeStateListener, RealtimeVideoFormat, RealtimeVideoTrack, type RemoteVideoStatistics, type RemoteVideoStatisticsListener, StorageService, type StorageServicing, type StorageUploadOptions, StoredFile, VideoContentMode, type VideoStatistics, type VideoStatisticsListener, XmaxClient, XmaxConfiguration, type XmaxConfigurationInit, XmaxEnvironment, XmaxError, XmaxErrorCode, type XmaxErrorListener, XmaxLogger, XmaxLoggerOption, type XmaxRealtimeManaging, XmaxRealtimeVideoView, XmaxVideoView, apiBaseURL, defaultCameraVideoFormat, defaultFrameRate };
+export { CameraPosition, type FrameInterpolationConfiguration, MediaService, type MediaServicing, type NetworkQualityLevel, type NetworkStatistics, type NetworkStatisticsListener, RealtimeConfiguration, type RealtimeConfigurationInit, RealtimeConnectionState, RealtimeContext, type RealtimeContextInit, type RealtimeLaunchTiming, type RealtimeLaunchTimingListener, RealtimeMediaStream, RealtimeModel, RealtimeReason, RealtimeState, type RealtimeStateListener, RealtimeVideoFormat, RealtimeVideoTrack, type RemoteVideoStatistics, type RemoteVideoStatisticsListener, RtcProvider, StorageService, type StorageServicing, type StorageUploadOptions, StoredFile, VideoContentMode, type VideoStatistics, type VideoStatisticsListener, XmaxClient, XmaxConfiguration, type XmaxConfigurationInit, XmaxEnvironment, XmaxError, XmaxErrorCode, type XmaxErrorListener, XmaxLogger, XmaxLoggerOption, type XmaxRealtimeManaging, XmaxRealtimeVideoView, XmaxVideoView, apiBaseURL, defaultCameraVideoFormat, defaultFrameRate };

package/dist/index.d.ts

@@ -10,13 +10,15 @@ declare enum RealtimeModel {
      */
     x2_0 = "x2.0",
     /**
-     * Xmax X2.0 Pro 实时生成模型。
+     * Xmax X2.0 TRTC 实时生成模型。
      */
-    x2_0_pro = "x2.0-pro",
+    x2_0_trtc = "x2.0-trtc",
     /**
-     * Xmax X2.0 TRTC 实时生成模型。
+     * Xmax X2.0 Agora 实时生成模型。
      */
-    x2_0_trtc = "x2.0-trtc"
+    x2_0_agora = "x2.0-agora",
+    /** X2.1 预览模型；媒体规格与 x2.0-trtc 相同。 */
+    x2_1_preview = "x2.1-preview"
 }
 interface ModelSize {
     width: number;
@@ -124,6 +126,22 @@ interface StorageServicing {
     uploadImage(options: StorageUploadOptions): Promise<StoredFile>;
 }
 
+/**
+ * 实时媒体使用的 RTC 提供方；一个 Manager 生命周期内保持不变。
+ */
+declare enum RtcProvider {
+    /**
+     * 腾讯实时音视频。
+     */
+    trtc = "trtc",
+    /**
+     * 声网实时音视频。
+     */
+    agora = "agora",
+    /** 火山引擎实时音视频。 */
+    vertc = "vertc"
+}
+
 /**
  * 远端视频插帧的开关与显示帧率配置。
  */
@@ -138,6 +156,10 @@ interface FrameInterpolationConfiguration {
     targetFrameRate?: number;
 }
 interface RealtimeConfigurationInit {
+    /**
+     * RTC 提供方，默认 TRTC；不根据模型名称自动推断。
+     */
+    provider?: RtcProvider;
     /**
      * 实时生成业务使用的模型。
      */
@@ -156,6 +178,10 @@ interface RealtimeConfigurationInit {
  * 创建实时 Manager 所需的业务配置。
  */
 declare class RealtimeConfiguration {
+    /**
+     * RTC 配置
+     */
+    readonly provider: RtcProvider;
     /**
      * 模型配置
      */
@@ -178,6 +204,7 @@ declare class RealtimeConfiguration {
      * 创建实时业务配置。
      *
      * @param init.model 实时生成业务使用的模型。
+     * @param init.provider RTC 提供方，默认 TRTC；创建后不可切换。
      * @param init.isFrameInterpolationEnabled 是否默认开启远端生成画面的插帧。
      * @param init.frameInterpolation 插帧开关和显示帧率上限的详细配置。
      */
@@ -185,7 +212,7 @@ declare class RealtimeConfiguration {
 }
 
 /**
- * TRTC 网络质量等级：未知、极好、良好、一般、差、极差、断网。
+ * RTC 网络质量等级：未知、极好、良好、一般、差、极差、断网。
  */
 type NetworkQualityLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /**
@@ -198,11 +225,11 @@ interface NetworkStatistics {
      */
     readonly downlinkQuality?: NetworkQualityLevel;
     /**
-     * 上行连接到 TRTC 云端的往返延迟，单位 ms，不是单程延迟。
+     * 上行连接到 RTC 云端的往返延迟，单位 ms，不是单程延迟；Agora 未提供时为空。
      */
     readonly uplinkRttMs?: number;
     /**
-     * 所有下行连接到 TRTC 云端的平均往返延迟，单位 ms。
+     * 所有下行连接到 RTC 云端的平均往返延迟，单位 ms；Agora 未提供时为空。
      */
     readonly downlinkRttMs?: number;
 }
@@ -534,6 +561,10 @@ type RealtimeLaunchTimingListener = (timing: RealtimeLaunchTiming) => void;
  * 视频流实际运行统计；缺失或无效指标为 undefined。
  */
 interface VideoStatistics {
+    /**
+     * 本端视频上行丢包率，单位 %；厂商未提供时为空。
+     */
+    readonly uplinkLossPercent?: number;
     readonly width?: number;
     readonly height?: number;
     /**
@@ -555,23 +586,24 @@ type VideoStatisticsListener = (statistics: VideoStatistics | undefined) => void
 interface RemoteVideoStatistics extends VideoStatistics {
     readonly userID: string;
     /**
-     * 本端 SDK 到 TRTC 云端的往返延迟，单位 ms；不是与远端用户之间的 RTT。
+     * 本端 SDK 到 RTC 云端的往返延迟，单位 ms；不是与远端用户之间的 RTT。
      */
     readonly rttMs?: number;
     /**
-     * 本端 SDK 到 TRTC 云端的上行丢包率，单位 %，不是结果流的发送端丢包率。
+     * 本端 SDK 到 RTC 云端的上行丢包率，单位 %，不是结果流的发送端丢包率。
      */
     readonly uplinkLossPercent?: number;
     /**
-     * TRTC 云端到本端 SDK 的下行丢包率，单位 %。
+     * RTC 云端到本端 SDK 的下行丢包率，单位 %。
      */
     readonly downlinkLossPercent?: number;
     /**
-     * 当前远端视频流的播放缓冲延迟，单位 ms。
+     * 当前远端视频流的播放缓冲延迟，单位 ms；Agora 未提供时为空。
      */
     readonly jitterBufferDelayMs?: number;
     /**
-     * TRTC 媒体端到端延迟估算值，单位 ms；不代表完整 AI 处理链路耗时。
+     * RTC 媒体端到端延迟估算值，单位 ms；不代表完整 AI 处理链路耗时。
+     * 采用各厂商原生口径，Agora end2EndDelay 不包含编码与解码耗时。
      */
     readonly endToEndDelayMs?: number;
 }
@@ -665,6 +697,17 @@ interface XmaxRealtimeManaging {
          */
         enableFrameValidation?: boolean;
     }): Promise<RealtimeMediaStream>;
+    /**
+     * 更新当前本地流的上行视频格式，立即应用于 RTC 编码器，不重连或重启生成。
+     * 传入完整格式；未指定的码率和编码偏好按 RealtimeVideoFormat 默认规则解析。
+     * 成功后更新本地轨道的 videoFormat，后续重连继续使用该格式。
+     * 模型生成及远端插帧仍使用创建本地流时的格式；此接口不改变生成尺寸。
+     * 实际发送规格受设备、浏览器和网络影响，应通过统计回调确认。
+     *
+     * @param videoFormat 本次完整的上行尺寸、帧率和编码配置。
+     * @throws 无本地相机流、其他操作进行中、参数无效或 RTC 更新失败时抛错。
+     */
+    updateVideoFormat(videoFormat: RealtimeVideoFormat): Promise<void>;
     /**
      * 停止本地相机流并释放本地预览与 RTC 资源。
      */
@@ -893,6 +936,7 @@ declare class XmaxClient {
     constructor(configuration: XmaxConfiguration);
     /**
      * 创建实时媒体 Manager。
+     * 模型专用地址优先于环境默认地址，并用于该 Manager 的整个会话生命周期。
      *
      * @param options 实时生成模型等业务配置。
      * @returns 可用于本地相机预览、实时连接与生成的实时 Manager。
@@ -1356,4 +1400,4 @@ declare class XmaxRealtimeVideoView {
     private showRemoteVideo;
 }
 
-export { CameraPosition, type FrameInterpolationConfiguration, MediaService, type MediaServicing, type NetworkQualityLevel, type NetworkStatistics, type NetworkStatisticsListener, RealtimeConfiguration, type RealtimeConfigurationInit, RealtimeConnectionState, RealtimeContext, type RealtimeContextInit, type RealtimeLaunchTiming, type RealtimeLaunchTimingListener, RealtimeMediaStream, RealtimeModel, RealtimeReason, RealtimeState, type RealtimeStateListener, RealtimeVideoFormat, RealtimeVideoTrack, type RemoteVideoStatistics, type RemoteVideoStatisticsListener, StorageService, type StorageServicing, type StorageUploadOptions, StoredFile, VideoContentMode, type VideoStatistics, type VideoStatisticsListener, XmaxClient, XmaxConfiguration, type XmaxConfigurationInit, XmaxEnvironment, XmaxError, XmaxErrorCode, type XmaxErrorListener, XmaxLogger, XmaxLoggerOption, type XmaxRealtimeManaging, XmaxRealtimeVideoView, XmaxVideoView, apiBaseURL, defaultCameraVideoFormat, defaultFrameRate };
+export { CameraPosition, type FrameInterpolationConfiguration, MediaService, type MediaServicing, type NetworkQualityLevel, type NetworkStatistics, type NetworkStatisticsListener, RealtimeConfiguration, type RealtimeConfigurationInit, RealtimeConnectionState, RealtimeContext, type RealtimeContextInit, type RealtimeLaunchTiming, type RealtimeLaunchTimingListener, RealtimeMediaStream, RealtimeModel, RealtimeReason, RealtimeState, type RealtimeStateListener, RealtimeVideoFormat, RealtimeVideoTrack, type RemoteVideoStatistics, type RemoteVideoStatisticsListener, RtcProvider, StorageService, type StorageServicing, type StorageUploadOptions, StoredFile, VideoContentMode, type VideoStatistics, type VideoStatisticsListener, XmaxClient, XmaxConfiguration, type XmaxConfigurationInit, XmaxEnvironment, XmaxError, XmaxErrorCode, type XmaxErrorListener, XmaxLogger, XmaxLoggerOption, type XmaxRealtimeManaging, XmaxRealtimeVideoView, XmaxVideoView, apiBaseURL, defaultCameraVideoFormat, defaultFrameRate };

package/dist/index.js

@@ -11,6 +11,7 @@ import {
   RealtimeVideoEncoderPreference,
   RealtimeVideoFormat,
   RealtimeVideoTrack,
+  RtcProvider,
   StorageService,
   StoredFile,
   VideoContentMode,
@@ -26,7 +27,7 @@ import {
   apiBaseURL,
   defaultCameraVideoFormat,
   defaultFrameRate
-} from "./chunk-YMLRUDAO.js";
+} from "./chunk-FMAQXPTE.js";
 export {
   CameraPosition,
   MediaService,
@@ -40,6 +41,7 @@ export {
   RealtimeVideoEncoderPreference,
   RealtimeVideoFormat,
   RealtimeVideoTrack,
+  RtcProvider,
   StorageService,
   StoredFile,
   VideoContentMode,

package/dist/react/index.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJWAAS6P4cjs = require('../chunk-JWAAS6P4.cjs');
+var _chunkFEL5MJMJcjs = require('../chunk-FEL5MJMJ.cjs');
 
 // src/react/XmaxRealtimeVideo.tsx
 
@@ -17,7 +17,7 @@ function XmaxRealtimeVideo(props) {
     if (!container) {
       return;
     }
-    const view = new (0, _chunkJWAAS6P4cjs.XmaxRealtimeVideoView)();
+    const view = new (0, _chunkFEL5MJMJcjs.XmaxRealtimeVideoView)();
     view.element.style.width = "100%";
     view.element.style.height = "100%";
     view.attach(container);
@@ -71,7 +71,7 @@ function XmaxVideo(props) {
     if (!container) {
       return;
     }
-    const view = new (0, _chunkJWAAS6P4cjs.XmaxVideoView)();
+    const view = new (0, _chunkFEL5MJMJcjs.XmaxVideoView)();
     view.element.style.width = "100%";
     view.element.style.height = "100%";
     view.attach(container);

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-weZCpU/source/packages/xmax-sdk/dist/react/index.cjs","../../src/react/XmaxRealtimeVideo.tsx","../../src/react/XmaxVideo.tsx"],"names":["useRef","useEffect","jsx"],"mappings":"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","file":"/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-weZCpU/source/packages/xmax-sdk/dist/react/index.cjs","sourcesContent":[null,"import {\n  VideoContentMode,\n  XmaxRealtimeVideoView,\n  type RealtimeVideoTrack,\n} from \"../index\";\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n} from \"react\";\n\nexport interface XmaxRealtimeVideoProps {\n  /**\n   * 当前显示的本地视频轨道。\n   */\n  localTrack?: RealtimeVideoTrack;\n\n  /**\n   * 当前显示的远端生成视频轨道；首帧提交后自动渐入。\n   */\n  remoteTrack?: RealtimeVideoTrack;\n\n  /**\n   * 视频内容在容器中的显示模式，默认 fill。\n   */\n  videoContentMode?: VideoContentMode;\n\n  /**\n   * 容器类名。\n   */\n  className?: string;\n\n  /**\n   * 容器样式。\n   */\n  style?: CSSProperties;\n}\n\n/**\n * 本地预览和远端生成画面自动切换的 React 组件。\n */\nexport function XmaxRealtimeVideo(props: XmaxRealtimeVideoProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const viewRef = useRef<XmaxRealtimeVideoView | undefined>(undefined);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    const view = new XmaxRealtimeVideoView();\n    view.element.style.width = \"100%\";\n    view.element.style.height = \"100%\";\n    view.attach(container);\n    viewRef.current = view;\n    return () => {\n      viewRef.current = undefined;\n      view.localTrack = undefined;\n      view.remoteTrack = undefined;\n      view.detach();\n    };\n  }, []);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.localTrack = props.localTrack;\n    }\n  }, [props.localTrack]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.remoteTrack = props.remoteTrack;\n    }\n  }, [props.remoteTrack]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.videoContentMode) {\n      view.videoContentMode = props.videoContentMode;\n    }\n  }, [props.videoContentMode]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={props.className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...props.style }}\n    />\n  );\n}\n","import {\n  VideoContentMode,\n  XmaxVideoView,\n  type RealtimeVideoTrack,\n} from \"../index\";\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n} from \"react\";\n\nexport interface XmaxVideoProps {\n  /**\n   * 当前显示的视频轨道；置空时清空画面。\n   */\n  track?: RealtimeVideoTrack;\n\n  /**\n   * 视频内容在容器中的显示模式，默认 fill。\n   */\n  videoContentMode?: VideoContentMode;\n\n  /**\n   * 是否镜像显示（仅影响显示，不影响发布流）。\n   */\n  mirrored?: boolean;\n\n  /**\n   * 容器类名。\n   */\n  className?: string;\n\n  /**\n   * 容器样式。\n   */\n  style?: CSSProperties;\n}\n\n/**\n * 单轨视频 React 组件：把一路视频轨渲染到容器。\n */\nexport function XmaxVideo(props: XmaxVideoProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const viewRef = useRef<XmaxVideoView | undefined>(undefined);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    const view = new XmaxVideoView();\n    view.element.style.width = \"100%\";\n    view.element.style.height = \"100%\";\n    view.attach(container);\n    viewRef.current = view;\n    return () => {\n      viewRef.current = undefined;\n      view.track = undefined;\n      view.detach();\n    };\n  }, []);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.track = props.track;\n    }\n  }, [props.track]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.videoContentMode) {\n      view.videoContentMode = props.videoContentMode;\n    }\n  }, [props.videoContentMode]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.mirrored !== undefined) {\n      view.isMirrored = props.mirrored;\n    }\n  }, [props.mirrored]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={props.className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...props.style }}\n    />\n  );\n}\n"]}
+{"version":3,"sources":["/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-sdawVu/source/packages/xmax-sdk/dist/react/index.cjs","../../src/react/XmaxRealtimeVideo.tsx","../../src/react/XmaxVideo.tsx"],"names":["useRef","useEffect","jsx"],"mappings":"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","file":"/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-sdawVu/source/packages/xmax-sdk/dist/react/index.cjs","sourcesContent":[null,"import {\n  VideoContentMode,\n  XmaxRealtimeVideoView,\n  type RealtimeVideoTrack,\n} from \"../index\";\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n} from \"react\";\n\nexport interface XmaxRealtimeVideoProps {\n  /**\n   * 当前显示的本地视频轨道。\n   */\n  localTrack?: RealtimeVideoTrack;\n\n  /**\n   * 当前显示的远端生成视频轨道；首帧提交后自动渐入。\n   */\n  remoteTrack?: RealtimeVideoTrack;\n\n  /**\n   * 视频内容在容器中的显示模式，默认 fill。\n   */\n  videoContentMode?: VideoContentMode;\n\n  /**\n   * 容器类名。\n   */\n  className?: string;\n\n  /**\n   * 容器样式。\n   */\n  style?: CSSProperties;\n}\n\n/**\n * 本地预览和远端生成画面自动切换的 React 组件。\n */\nexport function XmaxRealtimeVideo(props: XmaxRealtimeVideoProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const viewRef = useRef<XmaxRealtimeVideoView | undefined>(undefined);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    const view = new XmaxRealtimeVideoView();\n    view.element.style.width = \"100%\";\n    view.element.style.height = \"100%\";\n    view.attach(container);\n    viewRef.current = view;\n    return () => {\n      viewRef.current = undefined;\n      view.localTrack = undefined;\n      view.remoteTrack = undefined;\n      view.detach();\n    };\n  }, []);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.localTrack = props.localTrack;\n    }\n  }, [props.localTrack]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.remoteTrack = props.remoteTrack;\n    }\n  }, [props.remoteTrack]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.videoContentMode) {\n      view.videoContentMode = props.videoContentMode;\n    }\n  }, [props.videoContentMode]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={props.className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...props.style }}\n    />\n  );\n}\n","import {\n  VideoContentMode,\n  XmaxVideoView,\n  type RealtimeVideoTrack,\n} from \"../index\";\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n} from \"react\";\n\nexport interface XmaxVideoProps {\n  /**\n   * 当前显示的视频轨道；置空时清空画面。\n   */\n  track?: RealtimeVideoTrack;\n\n  /**\n   * 视频内容在容器中的显示模式，默认 fill。\n   */\n  videoContentMode?: VideoContentMode;\n\n  /**\n   * 是否镜像显示（仅影响显示，不影响发布流）。\n   */\n  mirrored?: boolean;\n\n  /**\n   * 容器类名。\n   */\n  className?: string;\n\n  /**\n   * 容器样式。\n   */\n  style?: CSSProperties;\n}\n\n/**\n * 单轨视频 React 组件：把一路视频轨渲染到容器。\n */\nexport function XmaxVideo(props: XmaxVideoProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const viewRef = useRef<XmaxVideoView | undefined>(undefined);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    const view = new XmaxVideoView();\n    view.element.style.width = \"100%\";\n    view.element.style.height = \"100%\";\n    view.attach(container);\n    viewRef.current = view;\n    return () => {\n      viewRef.current = undefined;\n      view.track = undefined;\n      view.detach();\n    };\n  }, []);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view) {\n      view.track = props.track;\n    }\n  }, [props.track]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.videoContentMode) {\n      view.videoContentMode = props.videoContentMode;\n    }\n  }, [props.videoContentMode]);\n\n  useEffect(() => {\n    const view = viewRef.current;\n    if (view && props.mirrored !== undefined) {\n      view.isMirrored = props.mirrored;\n    }\n  }, [props.mirrored]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={props.className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...props.style }}\n    />\n  );\n}\n"]}

package/dist/react/index.js

@@ -1,7 +1,7 @@
 import {
   XmaxRealtimeVideoView,
   XmaxVideoView
-} from "../chunk-YMLRUDAO.js";
+} from "../chunk-FMAQXPTE.js";
 
 // src/react/XmaxRealtimeVideo.tsx
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmaxai/web-sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "license": "MIT",
   "description": "XmaxSDK for Web — Realtime Interactive Video Generation",
   "type": "module",
@@ -40,6 +40,8 @@
     }
   },
   "dependencies": {
+    "@volcengine/rtc": "4.69.3",
+    "agora-rtc-sdk-ng": "4.24.8",
     "framegen": "1.4.0",
     "cos-js-sdk-v5": "^1.10.1",
     "trtc-sdk-v5": "^5.6.0"