diff --git a/dita/RTC-NG/API/api_imediaplayer_enableautoswitchagoracdn.dita b/dita/RTC-NG/API/api_imediaplayer_enableautoswitchagoracdn.dita
index 22c34baf497..3908b285946 100644
--- a/dita/RTC-NG/API/api_imediaplayer_enableautoswitchagoracdn.dita
+++ b/dita/RTC-NG/API/api_imediaplayer_enableautoswitchagoracdn.dita
@@ -1,12 +1,12 @@
-
+
如果你想设置 SDK 根据网络情况自动切换媒体资源 CDN 线路,你可以调用该方法。
请在
请在
方法成功调用时,无返回值;方法调用失败时,会抛出
调用该方法后,声网会打开媒体资源并通过自研调度中心请求媒体资源的所有 CDN 线路。默认使用第一个线路,你也可以通过
如果你希望保障连接和播放媒体资源的安全性,你可以
调用该方法后,声网会打开媒体资源并通过自研调度中心请求媒体资源的所有 CDN 线路。默认使用第一个线路,你也可以通过
如果你希望保障连接和播放媒体资源的安全性,你可以
鉴权信息说明:
方法成功调用时,无返回值;方法调用失败时,会抛出
当鉴权信息过期(超出
如果你在切换媒体资源线路 (
当鉴权信息过期(超出
如果你在切换媒体资源线路 (
为避免鉴权信息频繁过期,请务必根据场景需求设置合适的
为避免鉴权信息频繁过期,请务必根据场景需求设置合适的
方法成功调用时,无返回值;方法调用失败时,会抛出
通过
通过
-
方法成功调用时,无返回值;方法调用失败时,会抛出
如果用户需要自定义播放线路,你可以调用该方法实现媒体资源切换。声网会通过自研调度中心支持调度线路,提升观看用户体验。如果用户不需要自定义播放线路,你可以调用
如果用户需要自定义播放线路,你可以调用该方法实现媒体资源切换。声网会通过自研调度中心支持调度线路,提升观看用户体验。如果用户不需要自定义播放线路,你可以调用
如果媒体资源为直播流,你只能将该参数设置为
如果媒体资源为直播流,你只能将该参数设置为
方法成功调用时,无返回值;方法调用失败时,会抛出
+
该回调表示声网 CDN Token 即将过期。你需要调用
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
你可以使用该方法在本地视频流中叠加水印图像,并通过
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
你可以使用该方法在本地视频流上叠加水印图像。通过
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
创建一个
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回
方法调用成功,返回
+
该方法适用于偶尔进行语音通话或视频通话的应用程序,在不通话时释放资源以供其他操作使用。一旦调用该方法销毁已创建的
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
用于查询指定视频模块的 HDR 能力。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该方法通过指定的唯一 ID,从本地视频流中移除之前添加的水印图像。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
该方法用于更新 Token。Token 会在一定时间后失效,此时 SDK 将无法和服务器建立连接。
-在以下任意一种情况下,声网推荐你在你的服务端重新生成 Token,然后调用该方法传入新的 Token: -
在启用并使用 Token 后,Token 会在一段时间后过期。 + +在以下情况下,请在你的服务器上生成一个新的 Token,并调用该方法进行更新。否则,SDK 将与服务器断开连接: +
无。
方法成功调用时,无返回值;方法调用失败时,会抛出
方法成功调用时,无返回值;方法调用失败时,会抛出
-
同一用户可能使用两个设备分别发送音频流和视频流,为保证接收端听到和看到的音频和视频的时间同步性,你可以在视频发送端调用该方法,并传入音频发送端的频道名、用户 ID。 SDK 会以发送的音频流的时间戳为基准进行自动调节发送的视频流,以保证即使在两个发送端的上行网络情况不一致(如分别使用 Wi-Fi 和 4G 网络)的情况下,也能让接收到的音视频具有时间同步性。
-你可以通过该方法将本地用户与指定远端用户绑定为一个音视频同步组。远端用户由频道 ID 和用户 ID 唯一标识。使用限制:本地用户必须为视频流发送端。在接收端,同一同步组中的媒体流将进行时间同步。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法成功调用时,无返回值;方法调用失败时,会抛出
该方法仅对麦克风采集或自采集的音频有效,即对在
该方法仅对麦克风采集或自采集的音频有效,即对在
方法成功调用时,无返回值;方法调用失败时,会抛出
如果你设置的视频分辨率超出你的摄像头设备支持的范围,SDK 会根据你的设置进行自适应,取最接近、且长宽比与你设置的分辨率一致的值进行采集、编码、推流。你可以通过
方法成功调用时,无返回值;方法调用失败时,会抛出
-
SDK 会根据该采样间隔触发
用于设置
该方法需要在加入频道前调用。
-无。
方法成功调用时,无返回值;方法调用失败时,会抛出
方法成功调用时,无返回值;方法调用失败时,会抛出
SDK 不支持同一时间向同一个 URL 重复推流。
媒体选项说明
-SDK 不支持
SDK 不支持
如果你想推送主播端自定义采集的音视频流,请将媒体选项进行如下设置:
方法成功调用时,无返回值;方法调用失败时,会抛出
方法成功调用时,无返回值;方法调用失败时,会抛出
-
+
该回调在你将
在你将
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该回调在用户调用
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该方法在直播中向本地视频流添加 PNG 格式的水印图像。频道中的所有观众(包括 CDN 观众)以及采集设备都可以看到并捕捉到该水印图像。
+
+声网仅支持在本地视频中添加一个水印图像,新添加的图像会替换之前的图像。
+
+水印图像的位置取决于
该方法适用于多频道场景。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
调用
该方法适用于多频道场景。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该方法每次调用仅将一个指定音效预加载到内存中。若需预加载多个音效,请多次调用该方法。
+
+预加载完成后,你可以调用
该方法适用于多频道场景。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该方法适用于多频道场景。
+该方法适用于多频道场景。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该回调在调用
该回调在调用
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
用于获取视频特效中指定选项和键名对应的 float 类型参数值。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
用于获取视频特效中的整数类型参数。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
该方法用于获取水印图像的缓冲区或水印图像数据缓冲区。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功时,返回包含水印图像数据的
+
用于获取水印图像的格式。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回水印图像缓冲区的格式。
+
+
用于获取水印图像的高度。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回水印图像的高度,单位为像素。
+
+
用于从
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功时,返回水印的唯一 ID。方法调用失败时,返回空字符串。
+
+
用于获取水印图像的宽度。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回水印图像的宽度,单位为像素。
+
+
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功时,返回水印图像的 URL。方法调用失败时,返回空字符串。
+
+
用于获取当前配置的水印显示选项。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回
+
用于获取当前水印配置中的类型信息。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回水印类型。 +
+
获取横屏模式下水印的位置。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回一个包含四个元素的整数数组,表示水印矩形的 x、y、宽度和高度。
+
+
获取竖屏模式下水印的位置。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回一个包含四个元素的整数数组,表示水印矩形的 x、y、宽度和高度。
+
+
用于获取水印图像在 Z 轴上的绘制顺序索引。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
方法调用成功,返回水印图像的 Z 轴顺序索引。
+
+
检查水印在本地视频预览中是否可见。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
+
水印图像在视频中相对于其他叠加层的堆叠顺序。
+无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
-
当你调用
该回调表示声网 CDN Token 即将过期。你需要调用
无。
+方法成功调用时,无返回值;方法调用失败时,会抛出
@@ -18,7 +18,7 @@
value = v;
}
- @CalledByNative("CAMERA_DIRECTION")
+ @CalledByNative("CAMERA_DIRECTION")
public int getValue() {
return this.value;
}
@@ -36,7 +36,7 @@
value = v;
}
- @CalledByNative("CAMERA_FOCAL_LENGTH_TYPE")
+ @CalledByNative("CAMERA_FOCAL_LENGTH_TYPE")
public int getValue() {
return this.value;
}
@@ -65,25 +65,25 @@
this.fps = 15;
}
- @CalledByNative("CaptureFormat")
+ @CalledByNative("CaptureFormat")
public int getHeight() {
return height;
}
- @CalledByNative("CaptureFormat")
+ @CalledByNative("CaptureFormat")
public int getWidth() {
return width;
}
- @CalledByNative("CaptureFormat")
+ @CalledByNative("CaptureFormat")
public int getFps() {
return fps;
}
@Override
public String toString() {
- return "CaptureFormat{"
- + "width=" + width + ", height=" + height + ", fps=" + fps + '}';
+ return "CaptureFormat{"
+ + "width=" + width + ", height=" + height + ", fps=" + fps + '}';
}
}
@@ -147,10 +147,10 @@
@Override
public String toString() {
- return "CameraCapturerConfiguration{"
- + "cameraDirection=" + cameraDirection + ", captureDimensions=" + captureFormat
- + ", cameraId=" + cameraId + ", followEncodeDimensionRatio=" + followEncodeDimensionRatio
- + ", cameraFocalLengthType=" + cameraFocalLengthType + '}';
+ return "CameraCapturerConfiguration{"
+ + "cameraDirection=" + cameraDirection + ", captureDimensions=" + captureFormat
+ + ", cameraId=" + cameraId + ", followEncodeDimensionRatio=" + followEncodeDimensionRatio
+ + ", cameraFocalLengthType=" + cameraFocalLengthType + '}';
}
}
@@ -19,39 +19,41 @@
public interval:number = 0;
}
-
功能模块的类型:
+
+
+
用于配置多质量层级视频流中某一层的参数,包括视频尺寸、帧率以及是否启用该层视频流。
+
+
+
+
+