addLiveStreamTask abstract method
添加房间内推流任务。成功添加后当前用户可以收到该直播流的状态通知。通话中有效。
通过此接口可以实现增加一路旁路推流任务;若需推送多路流,则需多次调用该方法。
使用前提
请先通过 setChannelProfile 接口设置房间模式为直播模式。
调用时机
请在引擎初始化之后调用此接口,且该方法仅可在加入房间后调用。
说明
- 仅角色为主播的房间成员能调用此接口,观众成员无相关推流权限。
- 同一个音视频房间(即同一个 channelId)可以创建 6 个不同的推流任务。
参数说明
taskInfo
推流任务信息。
相关回调
- NERtcLiveTaskCallback.onAddLiveStreamTask:添加直播任务结果回调,操作成功后返回该回调。
- NERtcChannelEventCallback.onLiveStreamState:推流任务状态已改变回调。
返回值
- 0(OK):方法调用成功。
- 其他:方法调用失败。
- 403(reserveNoPermission):权限不足,观众模式下不支持此操作。
- 30003(invalidParam):参数错误,比如推流任务 ID 参数为空。
- 30005(invalidState):状态错误,比如引擎尚未初始化。
Implementation
Future<int> addLiveStreamTask(NERtcLiveStreamTaskInfo taskInfo);