NERtc Android SDK
V4.6.420
|
Public 成员函数 | |
abstract void | init (Context context, String appkey, NERtcCallback callback, NERtcOption option) throws Exception |
abstract void | release () |
abstract int | joinChannel (String token, String channelName, long uid) |
abstract int | updatePermissionKey (String key) |
abstract int | joinChannel (String token, String channelName, long uid, NERtcJoinChannelOptions channelOptions) |
abstract int | leaveChannel () |
abstract int | enableLocalAudio (boolean enable) |
abstract int | subscribeRemoteAudioStream (long uid, boolean subscribe) |
abstract int | subscribeAllRemoteAudioStreams (boolean subscribe) |
abstract int | setAudioProfile (int profile, int scenario) |
abstract int | setLocalVideoConfig (NERtcVideoConfig videoConfig) |
abstract int | setLocalVideoConfig (NERtcVideoConfig videoConfig, NERtcVideoStreamType streamType) |
abstract int | setCameraCaptureConfig (NERtcCameraCaptureConfig captureConfig) |
abstract int | setCameraCaptureConfig (NERtcCameraCaptureConfig captureConfig, NERtcVideoStreamType streamType) |
abstract int | startVideoPreview () |
abstract int | startVideoPreview (NERtcVideoStreamType streamType) |
abstract int | stopVideoPreview () |
abstract int | stopVideoPreview (NERtcVideoStreamType streamType) |
abstract int | setupLocalVideoCanvas (IVideoRender render) |
abstract int | setupRemoteVideoCanvas (IVideoRender render, long uid) |
abstract int | enableLocalVideo (boolean enable) |
abstract int | enableLocalVideo (NERtcVideoStreamType streamType, boolean enable) |
abstract int | subscribeRemoteVideoStream (long uid, NERtcRemoteVideoStreamType streamType, boolean subscribe) |
abstract void | setParameters (NERtcParameters params) throws IllegalArgumentException |
abstract String | getParameter (String parameterKey, String extraInfo) |
静态 Public 成员函数 | |
static NERtc | getInstance () |
static NERtcVersion | version () |
static List< String > | checkPermission (Context context) |
|
static |
检查音视频相关的多媒体设备权限。
通过本接口可以实现在音视频通话前,检查多媒体设备的权限,如相机、麦克风、扬声器、磁盘读写、网络权限等。
参数名称 | 类型 | 描述 |
---|---|---|
context | Context | 设备上下文。需要从应用层获取。 |
|
abstract |
开启或关闭本地音频的采集和发送。
通过本接口可以实现开启或关闭本地语音功能,进行本地音频采集及处理。
参数名称 | 类型 | 描述 |
---|---|---|
enable | boolean | 是否启用本地音频的采集和发送:
|
|
abstract |
开启或关闭本地视频的采集与发送。
通过本接口可以实现开启或关闭本地视频,不影响接收远端视频。
参数名称 | 类型 | 描述 |
---|---|---|
enable | boolean | 是否开启本地视频采集与发送:
|
|
abstract |
开启或关闭本地视频的采集与发送。
通过主流或辅流视频通道进行本地视频流的采集与发送。
参数名称 | 类型 | 描述 |
---|---|---|
streamType | video.NERtcVideoStreamType | 视频通道类型:
|
enable | boolean | 是否开启本地视频采集与发送:
|
|
static |
|
abstract |
以String 的形式获取一些内部参数,此接口为隐藏接口,需要特定参数及特定时机,详情联系技术支持。
parameterKey | 参数key |
extraInfo | 额外的信息 |
|
abstract |
创建 NERtc 实例。
通过本接口可以实现创建 NERtc 实例并初始化 NERTC SDK 服务。
参数名称 | 类型 | 描述 |
---|---|---|
context | Context | 传入的 RTC engine context 对象。 |
appkey | String | 应用的 App Key。在 云信控制台 创建应用后,可以查看对应的 App Key。 |
callback | NERtcCallback | 回调函数。所有接口均在主线程上回调,您可继承简易实现 AbsNERtcCallbackEx 类,或自行选择实现 NERtcCallback、NERtcCallbackEx 等类。 |
option | NERtcOption | 其他可选配置。可设置为 null。 |
|
abstract |
加入音视频房间。
通过本接口可以实现加入音视频房间,加入房间后可以与房间内的其他用户进行音视频通话。
参数名称 | 类型 | 描述 |
---|---|---|
token | String | 安全认证签名(NERTC Token),可以设置为:
|
channelName | String | 房间名称,设置相同房间名称的用户会进入同一个通话房间。
|
uid | long | 用户的唯一标识 ID。 |
|
abstract |
加入音视频房间。
通过本接口可以实现加入音视频房间,加入房间后可以与房间内的其他用户进行音视频通话。
参数名称 | 类型 | 描述 |
---|---|---|
token | String | 安全认证签名(NERTC Token),可以设置为:
|
channelName | String | 房间名称,设置相同房间名称的用户会进入同一个通话房间。
|
uid | long | 用户的唯一标识 ID。 |
channelOptions | NERtcJoinChannelOptions | 加入房间时设置一些特定的房间参数。默认值为 null。 |
|
abstract |
离开音视频房间。
通过本接口可以实现挂断或退出通话,并释放本房间内的相关资源。
|
abstract |
销毁 NERtc 实例,释放资源。
该方法释放 NERTC SDK 使用的所有资源。有些 App 只在用户需要时才进行实时音视频通信,完成音视频通话后,则将资源释放出来用于其他操作,该方法适用于此类情况。
leaveChannel
、并收到 onUserLeave
回调后调用。或收到 onDisconnect
回调、重连失败时调用此接口销毁实例,并释放资源。release
方法后,您将无法再使用 SDK 的其它方法和回调。如需再次使用实时音视频通话功能,您必须等待 release
方法执行结束后,重新创建一个新的 NERtc 实例。 init
初始化引擎失败,需要等待 release
同步返回后再次初始化引擎,否则重复初始化引擎,SDK 会抛出 RuntimeException。
|
abstract |
设置音频编码属性。
通过此接口可以实现设置音频编码的采样率、码率、编码模式、声道数等,也可以设置音频属性的应用场景,包括聊天室场景、语音场景、音乐场景等。
参数名称 | 类型 | 描述 |
---|---|---|
profile | int | 设置采样率、码率、编码模式和声道数。详细信息请参考 NERtcConstants.AudioProfile。 |
scenario | int | 设置音频应用场景。详细信息请参考 NERtcConstants.AudioScenario。 |
|
abstract |
设置本地摄像头的视频主流采集配置。
通过此接口可以设置本地摄像头采集的主流视频宽度、高度、旋转角度等。
参数名称 | 类型 | 描述 |
---|---|---|
captureConfig | video.NERtcCameraCaptureConfig | 本地摄像头采集配置。 |
|
abstract |
设置本地摄像头的视频主流或辅流采集配置。
通过此接口可以设置本地摄像头采集的主流或辅流视频宽度、高度、旋转角度等。
参数名称 | 类型 | 描述 |
---|---|---|
captureConfig | video.NERtcCameraCaptureConfig | 本地摄像头采集配置。 |
streamType | video.NERtcVideoStreamType | 视频通道类型:
|
|
abstract |
设置视频编码属性。
通过此接口可以设置视频主流的编码分辨率、裁剪模式、码率、帧率、带宽受限时的视频编码降级偏好、编码的镜像模式、编码的方向模式参数,详细信息请参考设置视频属性。
参数名称 | 类型 | 描述 |
---|---|---|
videoConfig | video.NERtcVideoConfig | 视频编码属性配置。 |
|
abstract |
设置视频编码属性。
通过此接口可以设置视频主流或辅流的编码分辨率、裁剪模式、码率、帧率、带宽受限时的视频编码降级偏好、编码的镜像模式、编码的方向模式参数,详细信息请参考设置视频属性。
参数名称 | 类型 | 描述 |
---|---|---|
streamType | boolean | 视频通道类型:
|
videoConfig | video.NERtcVideoConfig | 视频编码属性配置。 |
|
abstract |
设置音视频通话的相关参数。
此接口提供技术预览或特别定制功能,详情请咨询技术支持。
参数名称 | 类型 | 描述 |
---|---|---|
params | NERtcParameters | 音视频通话的参数集合。 |
|
abstract |
设置本地用户视图。
通过本接口可以实现绑定本地用户和显示视图,并设置本地用户视图在本地显示时的镜像模式和裁减比例,只影响本地用户看到的视频画面。
参数名称 | 类型 | 描述 |
---|---|---|
render | IVideoRender | 本地用户视频的画布。设置为 NULL 表示取消并释放已设置的画布,详细信息请参考 video.NERtcVideoView。 |
|
abstract |
设置远端用户视图。
通过本接口可以实现绑定远端用户和显示视图,并设置远端用户视图在本地显示时的镜像模式和裁减比例,只影响本地用户看到的视频画面。
参数名称 | 类型 | 描述 |
---|---|---|
render | IVideoRender | 远端用户视频的画布。详细信息请参考 video.NERtcVideoView。 |
uid | long | 远端用户的 ID。可以在 NERtcCallback#onUserJoined() 回调中获取。 |
|
abstract |
开启视频预览。
通过本接口可以实现在加入房间前启动本地视频预览,支持预览本地摄像头或外部输入视频。
|
abstract |
开启视频预览。
通过本接口可以实现在加入房间前启动本地视频预览,支持预览本地摄像头或外部输入视频。
参数名称 | 类型 | 描述 |
---|---|---|
streamType | video.NERtcVideoStreamType | 视频通道类型:
|
|
abstract |
停止视频预览。
通过此接口可以实现在预览本地视频后关闭预览。
|
abstract |
停止视频预览。
通过本接口可以实现在预览本地视频后关闭预览。
参数名称 | 类型 | 描述 |
---|---|---|
streamType | video.NERtcVideoStreamType | 视频通道类型:
|
|
abstract |
取消或恢复订阅所有远端用户的音频主流。
加入房间时,默认订阅所有远端用户的音频主流,即 NERtc#setParameters() 方法的 KEY_AUTO_SUBSCRIBE_AUDIO 参数默认设置为 true;只有当该参数的设置为 false 时,此接口的调用才会生效。
参数名称 | 类型 | 描述 |
---|---|---|
subscribe | boolean | 是否订阅所有用户的音频主流:
|
|
abstract |
取消或恢复订阅指定远端用户的音频主流。
加入房间时,默认订阅所有远端用户的音频主流,您也可以通过此方法取消或恢复订阅指定远端用户的音频主流。
参数名称 | 类型 | 描述 |
---|---|---|
uid | long | 指定用户的 ID。 |
subscribe | boolean | 是否订阅指定用户的音频主流:
|
|
abstract |
订阅或取消订阅指定远端用户的视频主流。
加入房间后,默认不订阅所有远端用户的视频主流;若您希望看到指定远端用户的视频,可以在监听到对方加入房间或发布视频流之后,通过此方法订阅该用户的视频主流。
参数名称 | 类型 | 描述 |
---|---|---|
uid | long | 指定用户的 ID。 |
streamType | video.NERtcRemoteVideoStreamType | 订阅的视频流类型:
|
subscribe | boolean | 是否订阅远端用户的视频流:
|
|
abstract |
更新权限密钥。
参数名称 | 类型 | 描述 |
---|---|---|
key | String | 新的权限密钥。 |