|
JCSDK-iOS
|
#import <JCMediaChannel.h>
构造函数 | |
| (void) | - destroy |
| (bool) | - setConfig:value: |
| (NSString *__nullable) | - getConfig: |
| (int) | - query: |
| (bool) | - join:joinParam: |
| (bool) | - leave |
| (bool) | - stop |
| (bool) | - enableUploadAudioStream: |
| (bool) | - enableUploadVideoStream: |
| (bool) | - enableAudioOutput: |
| (bool) | - requestVideo:pictureSize: |
| (bool) | - enableScreenShare: |
| (bool) | - requestScreenVideo:pictureSize: |
| (bool) | - enableCdn:keyInterval: |
| (bool) | - enableRemoteRecord:recordParam: |
| (bool) | - enableLocalRecord:recordParam: |
| (bool) | - enableLocalRecord:path: |
| (JCMediaChannelParticipant *__nullable) | - getParticipant: |
| (NSString *__nullable) | - getStatistics |
| (bool) | - setCustomProperty:forKey: |
| (NSString *__nullable) | - getCustomProperty: |
| (bool) | - sendMessage:content:toUserId: |
| (int) | - inviteSipUser:sipParam: |
| (bool) | - sendCommand:commandParam: |
| (bool) | - setRatio: |
| (bool) | - setScreenMode: |
| (int) | - generateRoomId |
| (bool) | - sendVideoEmptyPack: |
| (bool) | - sendAudioEmptyPack: |
类方法 | |
| (JCMediaChannel *__nullable) | + create:mediaDevice:callback: |
属性 | |
| NSString * | channelUri |
| NSString * | channelId |
| int | channelNumber |
| long | confId |
| NSString * | password |
| JCMediaChannelState | state |
| NSArray * | participants |
| bool | uploadLocalAudio |
| bool | uploadLocalVideo |
| bool | audioOutput |
| NSString * | screenRenderId |
| NSString * | screenUserId |
| bool | localRecording |
| NSString * | title |
| JCMediaChannelRecordState | recordState |
| JCMediaChannelCdnState | cdnState |
| int | spkLevel |
| int | micLevel |
类似音视频频道的概念,可以通过频道号加入此频道,从而进行音视频通话
| + (JCMediaChannel* __nullable) create: | (JCClient *__nonnull) | client | |
| mediaDevice: | (JCMediaDevice *__nonnull) | mediaDevice | |
| callback: | (id< JCMediaChannelCallback > __nonnull) | callback | |
创建 JCMediaChannel 对象
JCMediaChannel 的所有接口函数,如无特殊说明,都建议在主线程调用
| client | JCClient 对象 |
| mediaDevice | JCMediaDevice 对象 |
| callback | JCMediaChannelCallback 对象,用于回调相关通知 |
| JCClient、JCMediaDevice、JCMediaChannelCallback 任意一个参数传空就会出现调用失败 |
| - (void) destroy |
销毁 JCMediaChannel 对象
| - (bool) enableAudioOutput: | (bool) | enable |
开启/关闭远端音频输出
该方法可实现本地静音功能。关闭时听不到频道内其他成员的声音,不影响其他成员;开启时可以听到其他成员声音
初始化 JCMediaChannel 时,音频输出功能默认是开启的。若要加入频道时听不见其他成员的声音,建议在调用 join 加入频道前设置
该方法可以关闭或重新开启音频输出功能,在频道内和频道外均可调用,且在离开频道后该设置仍然有效,也就是说这一次设置了关闭音频输出,那么下一次加入频道时也是默认关闭音频输出
| enable | 是否开启音频输出
|
| - (bool) enableCdn: | (bool) | enable | |
| keyInterval: | (int) | keyInterval | |
开启/关闭Cdn推流
在收到 onMediaChannelPropertyChange 回调后检查是否开启
| enable | 开启/关闭Cdn推流
|
| keyInterval | 推流关键帧间隔(毫秒),当参数 enable 为 true 时有效,有效值需要>=1000 |
| - (bool) enableLocalRecord: | (bool) | enable | |
| path: | (NSString *__nonnull) | path | |
本地录制
| enable | 开启关闭 |
| path | 录制路径 |
| - (bool) enableLocalRecord: | (bool) | enable | |
| recordParam: | (JCMediaChannelRecordLocalParams *__nullable) | recordParam | |
本地会议录制
| enable | 开启或者关闭录制 |
| recordParam | 录制参数 |
| - (bool) enableRemoteRecord: | (bool) | enable | |
| recordParam: | (JCMediaChannelRecordRemoteParams *__nullable) | recordParam | |
开启/关闭视频录制
| enable | 开启/关闭视频录制
|
| recordParam | JCMediaChannelRecordParam 录制参数对象,当参数 enable 为 true 时,可以更改由 join 时传入的录制参数,不需更改则填 nil |
| - (bool) enableScreenShare: | (bool) | enable |
开启/关闭屏幕分享
在频道中时调用此方法才有效
| enable | 开启/关闭屏幕分享
|
| - (bool) enableUploadAudioStream: | (bool) | enable |
开启/关闭发送本地音频流
调用该方法可开启或关闭发送本地音频流。开启后,频道成员将听见本端声音;关闭后,频道成员将听不见本端声音
初始化 JCMediaChannel 时,默认不发送本地音频流。若要加入频道时,让频道内其他成员听见本端声音,需要在调用 join 加入频道前设置
该方法在频道内和频道外均可调用,且在离开频道后该设置仍然有效。也就是说这一次设置了开启发送本地音频流,那么在下一次加入频道时默认会开启发送本地音频流
会议中也可调用此方法开启或关闭发送本地音频流,服务器会更新状态并同步给其他频道成员
会议中调用此方法不影响接收远端音频
| enable | 开启/关闭发送本地音频流
|
| - (bool) enableUploadVideoStream: | (bool) | enable |
开启/关闭发送本地视频流
调用该方法可开启或关闭发送本地视频流。开启后,频道成员将可以看见本端视频画面;关闭后,频道成员将看不见本端视频画面
初始化 JCMediaChannel 时,默认发送本地视频流。若要加入频道时,让频道内其他成员看见本端视频画面,建议在调用 join 加入频道前设置
该方法在频道内和频道外均可调用,且在离开频道后该设置仍然有效。也就是说这一次设置了关闭发送本地视频流,那么在下一次加入频道时默认会关闭发送本地视频流
会议中也可调用此方法开启或关闭发送本地视频流,服务器会更新状态并同步给其他频道成员
会议中调用此方法不影响接收远端视频
| enable | 是否发送本地视频流
|
| - (int) generateRoomId |
生成会议号
| - (NSString* __nullable) getConfig: | (NSString *__nonnull) | key |
获取配置相关参数
| key | 参数关键字, 参见 JCMediaChannelConstants |
| - (NSString* __nullable) getCustomProperty: | (NSString *__nonnull) | key |
获取自定义频道属性。 调用此接口来获取自定义频道属性
| key | 自定义属性 key |
| - (JCMediaChannelParticipant* __nullable) getParticipant: | (NSString *__nonnull) | userId |
| - (NSString *) getStatistics |
获取统计信息
以Json字符串形式返回,其中包含 "Config", "Network","Transport" 和 "Participants" 4个节点
| - (int) inviteSipUser: | (NSString *__nonnull) | userId | |
| sipParam: | (NSString *__nullable) | sipParam | |
邀请Sip用户
一般用于对接落地网关等,结果通过 onInviteSipUserResult 通知
| userId | 一般为号码 |
| sipParam | nil 或者通过 JCMediaChannelUtils.buildSipParam 构造 |
| - (bool) join: | (NSString *__nonnull) | channelIdOrUri | |
| joinParam: | (JCMediaChannelJoinParam *__nullable) | joinParam | |
加入频道
该方法让用户加入通话频道,在同一个频道内的用户可以互相通话
如果已在频道中,用户必须退出当前频道,即处于空闲状态,才能进入下一个频道,否则将直接返回 false
| channelIdOrUri | 媒体频道标识或者频道Uri,当入参 JCMediaChannelJoinParam 对象 中 uriMode 设置为 true 时表示频道 channelUri ,否则表示频道标识 channelId |
| joinParam | JCMediaChannelJoinParam 对象,没有则填 nil |
| - (bool) leave |
| - (int) query: | (NSString *__nonnull) | channelId |
| - (bool) requestScreenVideo: | (NSString *__nonnull) | screenUri | |
| pictureSize: | (JCMediaChannelPictureSize) | pictureSize | |
请求频道成员屏幕共享的视频流
当 pictureSize 为 JCMediaChannelPictureSizeNone 表示关闭请求
| screenUri | 屏幕分享uri |
| pictureSize | 视频请求尺寸类型,参见: |
| - (bool) requestVideo: | (JCMediaChannelParticipant *__nonnull) | participant | |
| pictureSize: | (JCMediaChannelPictureSize) | pictureSize | |
请求频道中其他用户的视频流
当 pictureSize 为 JCMediaChannelPictureSizeNone 时表示关闭请求
| participant | JCMediaChannelParticipant 频道中其他成员对象 |
| pictureSize | 视频请求的尺寸类型: |
| - (bool) sendAudioEmptyPack: | (bool) | empty |
音频发送空包 该接口不会导致成员的Audio属性变化
| empty | 音频发送包是否空包
|
| - (bool) sendCommand: | (NSString *__nonnull) | name | |
| commandParam: | (NSString *__nonnull) | param | |
发送指令
| name | 指令名 |
| param | 指令参数 |
| - (bool) sendMessage: | (NSString *__nonnull) | type | |
| content: | (NSString *__nonnull) | content | |
| toUserId: | (NSString *__nullable) | toUserId | |
发送消息
此接口调用成功后,消息接收方会收到 onMessageReceive 回调,通过此回调可以获取消息的文本类型和文本内容
| type | 消息类型 |
| content | 消息内容,不能为空,并且当 toUserId 不为 nil 时,content 不能大于 4k |
| toUserId | 接收者id,传入 nil 则发给频道所有人员 |
| - (bool) sendVideoEmptyPack: | (bool) | empty |
视频发送空包 该接口不会导致成员的Video属性变化
| empty | 视频发送包是否空包
|
| - (bool) setConfig: | (NSString *__nonnull) | key | |
| value: | (NSString *__nonnull) | value | |
设置配置相关参数
| key | 参数关键字 |
| value | 参数值 |
| - (bool) setCustomProperty: | (NSString *__nonnull) | value | |
| forKey: | (NSString *__nonnull) | key | |
设置媒体频道中的自定义属性(设置涂鸦拥有者等)
| value | 自定义属性的value值 |
| key | 自定义属性的key值 |
| - (bool) setRatio: | (float) | ratio |
设置宽高比
| ratio | 宽高比 |
| - (bool) setScreenMode: | (JCMediaChannelConfMergeModeParam *__nonnull) | param |
设置分屏模式
| param | 媒体推流的视频合并模式参数 |
| - (bool) stop |
关闭频道
此频道内的成员都将被强制退出
|
readnonatomicassign |
是否音频输出
本地没有音频输出的话,就听不到频道内其他成员的声音了
|
readnonatomicassign |
获得cdn推流状态
|
readnonatomiccopy |
频道标识
|
readnonatomicassign |
频道号
|
readnonatomiccopy |
频道 Uri
不管加入频道时使用的是不是 uri 模式,都能获取到频道 Uri
|
readnonatomicassign |
会议号
|
readnonatomicassign |
是否正在本地录制
|
readnonatomicassign |
当前本地记录音量级别
|
readnonatomicstrong |
获得频道中的所有成员
|
readnonatomiccopy |
频道密码
|
readnonatomicassign |
获得视频录制状态,参见:
|
readnonatomiccopy |
屏幕共享渲染标识
没有屏幕共享则为 nil
|
readnonatomiccopy |
屏幕共享用户标识
没有屏幕共享则为 nil
|
readnonatomicassign |
当前扬声器音量级别
|
readnonatomicassign |
自己当前在频道中的状态
当前在频道中的状态,参见:
|
readnonatomiccopy |
频道标题
|
readnonatomicassign |
是否上传本地音频数据
|
readnonatomicassign |
是否上传本地视频数据