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