public abstract class NERtc
extends java.lang.Object
构造器和说明 |
---|
NERtc() |
限定符和类型 | 方法和说明 |
---|---|
static java.util.List<java.lang.String> |
checkPermission(android.content.Context context)
音视频通话相关的多媒体设备权限检查。
|
abstract int |
enableLocalAudio(boolean enable)
开启/关闭本地音频采集。
|
abstract int |
enableLocalVideo(boolean enable)
是否开启本地视频采集。
|
static NERtc |
getInstance()
获取 NERtc 实例。
|
abstract void |
init(android.content.Context context,
java.lang.String appkey,
NERtcCallback callback,
NERtcOption option)
创建 NERtc 实例并初始化 NERTC SDK 服务。
|
abstract int |
joinChannel(java.lang.String token,
java.lang.String channelName,
long uid)
加入音视频房间。
|
abstract int |
leaveChannel()
离开房间,即挂断或退出通话。
|
abstract void |
release()
销毁 NERtc 实例,释放资源。
|
abstract int |
setAudioProfile(int profile,
int scenario)
设置音频编码属性。
|
abstract int |
setLocalVideoConfig(NERtcVideoConfig videoConfig)
设置视频编码属性。
|
abstract void |
setParameters(NERtcParameters params)
设置音视频通话的相关参数。
|
abstract int |
setupLocalVideoCanvas(com.netease.lava.api.IVideoRender render)
设置本地视图。
|
abstract int |
setupRemoteVideoCanvas(com.netease.lava.api.IVideoRender render,
long uid)
设置远端用户视图。
|
abstract int |
startVideoPreview()
开启视频预览。
|
abstract int |
stopVideoPreview()
停止视频预览。
|
abstract int |
subscribeAllRemoteAudioStreams(boolean subscribe)
取消或恢复订阅所有远端用户音频流。
|
abstract int |
subscribeRemoteAudioStream(long uid,
boolean subscribe)
取消或恢复订阅指定远端用户音频流。
|
abstract int |
subscribeRemoteVideoStream(long uid,
NERtcRemoteVideoStreamType streamType,
boolean subscribe)
订阅或取消订阅指定远端用户的视频流。
|
static NERtcVersion |
version()
查询 SDK 版本号。
|
public static NERtc getInstance()
public abstract void init(android.content.Context context, java.lang.String appkey, NERtcCallback callback, NERtcOption option) throws java.lang.Exception
context
- 传入的 RTC engine context 对象。appkey
- 应用的 App Key。在 云信控制台 创建应用后,可以查看对应的 App Key。callback
- 回调函数,所有接口均在主线程上回调。option
- 其他可选配置,详细信息请参考 NERtcOption
。可设置为 null。java.lang.Exception
public abstract void release()
注意:如需在销毁后再次创建 NERtc 实例,需要等待 release()
方法执行结束后再创建实例。
public abstract int joinChannel(java.lang.String token, java.lang.String channelName, long uid)
token
- 安全认证签名(NERTC Token)。可设置为:
channelName
- 房间名称,设置相同房间名称的用户会进入同一个通话房间。
uid
- 用户的唯一标识 id,房间内每个用户的 uid 必须是唯一的。不可设置为 0 或负数。0
方法调用成功,其他失败leaveChannel()
public abstract int leaveChannel()
0
成功,其他失败.joinChannel(String, String, long)
public abstract int enableLocalAudio(boolean enable)
注意:
enable
- 是否开启本地语音。
0
方法调用成功,其他失败public abstract int subscribeRemoteAudioStream(long uid, boolean subscribe)
注意:该方法需要在加入房间后调用。
uid
- 指定用户的 ID。subscribe
- 是否订阅指定音频流。
0
方法调用成功,其他失败public abstract int subscribeAllRemoteAudioStreams(boolean subscribe)
注意:
subscribe
- 是否取消订阅所有远端用户的音频流。
0
方法调用成功,其他失败public abstract int setAudioProfile(int profile, int scenario)
注意:该方法需要在 joinChannel 之前设置,joinChannel 后设置不生效。
profile
- 设置采样率、码率、编码模式和声道数。详细信息请参考 NERtcConstants.AudioProfile
。scenario
- 设置音频应用场景。详细信息请参考 NERtcConstants.AudioScenario
。0
方法调用成功,其他失败public abstract int setLocalVideoConfig(NERtcVideoConfig videoConfig)
注意:
videoConfig
- 视频编码属性配置,详细信息请参考 NERtcVideoConfig
。0
方法调用成功,其他调用失败public abstract int startVideoPreview()
0
方法调用成功,其他调用失败public abstract int stopVideoPreview()
注意:该方法需要在加入房间前调用。
0
方法调用成功,其他调用失败public abstract int setupLocalVideoCanvas(com.netease.lava.api.IVideoRender render)
render
- 视频画布。详细信息请参考 NERtcVideoView。0
方法调用成功,其他调用失败NERtcVideoView
public abstract int setupRemoteVideoCanvas(com.netease.lava.api.IVideoRender render, long uid)
注意:
render
- 视频画布。详细信息请参考 NERtcVideoView。uid
- 远端用户 ID。0
方法调用成功,其他调用失败NERtcVideoView
public abstract int enableLocalVideo(boolean enable)
注意:
enable
- 是否启用本地视频采集:
0
方法调用成功,其他调用失败public abstract int subscribeRemoteVideoStream(long uid, NERtcRemoteVideoStreamType streamType, boolean subscribe)
uid
- 指定用户的用户 ID。streamType
- 订阅的视频流类型,详细信息请参考 NERtcRemoteVideoStreamType
。subscribe
- 是否取消订阅本地视频流。
0
方法调用成功,其他调用失败public abstract void setParameters(NERtcParameters params) throws java.lang.IllegalArgumentException
注意:
params
- 音视频通话的相关参数。java.lang.IllegalArgumentException
public static NERtcVersion version()
NERtcVersion
版本号public static java.util.List<java.lang.String> checkPermission(android.content.Context context)
context
- 上下文。