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 |
是否上传本地视频数据