# 通用设备管理 (/zh-CN/api-reference/rtc/macos/device-management/common-device) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## enumerateDevices: [#enumeratedevices] 枚举系统中的所有音频和视频设备。 ```objc - (NSArray * _Nullable)enumerateDevices:(AgoraMediaDeviceType)type NS_SWIFT_NAME(enumerateDevices(_:)); ``` 该方法返回一个 `NSArray` 对象,其中包含系统中的所有音频和视频设备。你可以使用 `NSArray` 类型的 [AgoraRtcDeviceInfo](/zh-CN/api-reference/rtc/macos/class-agorartcdeviceinfo) 对象来枚举设备。 :::note 注: 请勿在主线程中调用此方法。 ::: ### 参数 [#参数] 设备类型,包括音频采集、音频播放、视频采集或视频播放设备。详见 [AgoraMediaDeviceType](/zh-CN/api-reference/rtc/macos/enum-mediadevicetype)。 ### 返回值 [#返回值] - 方法调用成功,返回一个包含所有音频和视频设备的 `NSArray` 对象,详见 [AgoraRtcDeviceInfo](/zh-CN/api-reference/rtc/macos/class-agorartcdeviceinfo)。 - 方法调用失败,返回 nil。 ### 所属接口类 [#所属接口类] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) ## getDeviceInfo: [#getdeviceinfo] 获取当前设备名称。 ```objc - (AgoraRtcDeviceInfo * _Nullable)getDeviceInfo:(AgoraMediaDeviceType)type NS_SWIFT_NAME(getDeviceInfo(_:)); ``` 你可以通过该方法,根据 `type` 参数的设置,获取当前的音频或视频采集设备。 ### 参数 [#参数-1] 设备类型,包括音频采集、音频播放、视频采集或视频播放设备。详见 [AgoraMediaDeviceType](/zh-CN/api-reference/rtc/macos/enum-mediadevicetype)。 ### 返回值 [#返回值-1] - 方法调用成功时,返回一个 [AgoraRtcDeviceInfo](/zh-CN/api-reference/rtc/macos/class-agorartcdeviceinfo) 对象。 - 方法调用失败时,返回 nil。 ### 所属接口类 [#所属接口类-1] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) ## getDeviceVolume: [#getdevicevolume] 获取当前设备的音量。 ```objc - (int)getDeviceVolume:(AgoraMediaDeviceType)type NS_SWIFT_NAME(getDeviceVolume(_:)); ``` ### 参数 [#参数-2] 设备类型,包括音频采集、音频播放、视频采集或视频播放设备。详见 [AgoraMediaDeviceType](/zh-CN/api-reference/rtc/macos/enum-mediadevicetype)。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) ## monitorDeviceChange: [#monitordevicechange] 监控设备状态变化。 ```objc - (void)monitorDeviceChange:(BOOL)enabled NS_SWIFT_NAME(monitorDeviceChange(_:)); ``` 你可以通过该方法监控外部音视频设备(如外接摄像头)的插拔和更换。 ### 参数 [#参数-3] 是否监控设备状态变化: - YES:开启设备状态监控。 - NO:关闭设备状态监控。 ### 所属接口类 [#所属接口类-3] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) ## setDeviceVolume\:volume: [#setdevicevolumevolume] 设置指定设备的音量。 ```objc - (int)setDeviceVolume:(AgoraMediaDeviceType)type volume:(int)volume NS_SWIFT_NAME(setDeviceVolume(_:volume:)); ``` 设置音频或视频采集或播放设备的音量。 :::note 注: 请在加入频道后调用该方法。 ::: ### 参数 [#参数-4] 设备类型,包括音频采集、音频播放、视频采集或视频播放设备,详见 [AgoraMediaDeviceType](/zh-CN/api-reference/rtc/macos/enum-mediadevicetype)。 指定设备的音量,取值范围为 [0, 255]。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) ## rtcEngine\:device\:type\:stateChanged: [#rtcenginedevicetypestatechanged] 报告设备状态的变化回调。 ```objc - (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine device:(NSString * _Nonnull)deviceId type:(AgoraMediaDeviceType)deviceType stateChanged:(NSInteger)state NS_SWIFT_NAME(rtcEngine(_:device:type:stateChanged:)); ``` :::note 注: 该回调仅适用于 macOS 平台。 ::: ### 调用时机 [#调用时机] 该回调在设备状态发生变化时被触发。 ### 参数 [#参数-5] 你使用的 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)。 设备的 ID。 设备类型,详见 [AgoraMediaDeviceType](/zh-CN/api-reference/rtc/macos/enum-mediadevicetype)。 设备的状态: - 0:已添加。 - 8:已移除。 ### 所属接口类 [#所属接口类-5] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)