视频设备管理
- macOS
更新时间不可用
queryCodecCapability
查询设备支持的视频编解码能力。
- (NSArray <AgoraVideoCodecCapInfo *> *_Nullable)queryCodecCapability;返回值
- 方法调用成功时,返回一个 AgoraVideoCodecCapInfo 数组,表示设备的视频编码能力,详见 AgoraVideoCodecCapInfo。
- 方法调用失败时,返回 nil。如果调用超时,请调整调用逻辑,避免在主线程中调用该方法。
所属接口类
setCameraCapturerConfiguration:
设置视频采集配置。
- (int)setCameraCapturerConfiguration:(AgoraCameraCapturerConfiguration * _Nullable)config NS_SWIFT_NAME(setCameraCapturerConfiguration(_:));在启用本地摄像头采集前调用此方法,例如在调用 startPreview: 和 joinChannelByToken 之前。
注: 如需调整摄像头焦距配置,建议先调用 queryCameraFocalLengthCapability 查询设备的焦距能力,并根据查询结果进行配置。
调用时机
在启用本地摄像头采集前调用,例如在调用 startPreview: 和 joinChannelByToken 之前。
参数
| 参数名 | 描述 |
|---|---|
config |
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setDevice:deviceId:
指定具有设备 ID 的设备。
- (int)setDevice:(AgoraMediaDeviceType)type deviceId:(NSString * _Nonnull)deviceId NS_SWIFT_NAME(setDevice(_:deviceId:));参数
| 参数名 | 描述 |
|---|---|
type | 设备类型,包括音频采集、音频播放、视频采集或视频播放设备。详见 AgoraMediaDeviceType。 |
deviceId | 设备 ID。你可以通过调用 enumerateDevices: 获取设备 ID。连接或断开音频设备不会改变该值。 |
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。