# 频道管理
# 1.create method
static Future<Map>create(String appId,String channelName,String nickname)
Manis
类的所有接口函数,如无特殊说明,都是异步调用,对接口的调用建议在同一个线程进行。
Note
- 请确保在调用其他 API 前先调用该方法创建并初始化
Manis
。 - Parameter
appId
: 为 app 开发者签发的 App ID,详见获取 App ID。使用同一个 App ID 的 app 才能进入同一个频道进行通话。一个 App ID 只能用于创建一个 Manis。 如需更换 App ID,必须先调用 destroy 销毁当前Manis
,再调用 create 重新创建Manis
。 - Parameter
channelName
:为加入的频道名称,只有使用同一个频道名称才能进入到同一个频道。 - Parameter
nickname
: 为加入频道人员的昵称。
Returns
- 方法调用成功,则返回一个
Map
对象,包括token
、channelId
以及appkey
。 - 方法调用失败,则返回错误码。
# 2.destroy method
static Future<void>destory()
释放资源
# 3.joinChannel method
static Future<bool> joinChannel(
String token, String channelId, String info, int uid)
根据token
加入channel
Parameter token
:在 App 服务器端生成的用于鉴权的 token
,该token
为create
接口返回的token
。
Parameter channelId
: 频道号,由create
接口返回。
Parameter info
:开发者需加入的任何附加信息。一般可设置为空字符串,或频道相关信息。该信息不会传递给频道内的其他用户。
Parameter uid
: 用户id。
# 4.leaveChannel method
static Future<bool> leaveChannel()
离开当前频道。
成功调用该方法离开频道后,会触发如下回调:
- 本地:onLeaveChannel.
- 远端:onUserOffline。