视频设备管理

  • macOS

更新时间不可用

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:方法调用失败。详见错误码了解详情和解决建议。

所属接口类