Android移动端音视频的快速开发教程（十）

4.7. 系统设置 4.7.1. 枚举本地视频采集设备 INT EnumVideoCapture(CHAR** lpDeviceName, INT& dwDeviceNum); 功能：枚举本地视频采集设备 返回值：0表示成功，不然为出错代码 参数： lpDeviceName 视频设备名称，可为空，表示只获取设备数量； dwDeviceNum 视频设备数量; 备注： 该方法将会在内部分配缓冲区，外部使用完成以后，必需手工释放这些缓冲区，不然会形成内存泄露，因为内部采用了“GlobalAlloc”来分配高端内存，故外部须要调用“GlobalFree”来释放，而不能是delete或free方法，具体使用方法请参考Demo程序中的源代码。 4.7.2. 选择指定的视频采集设备 INT SelectVideoCapture(STRING szCaptureName); 功能：选择指定的视频采集设备 返回值：0表示成功，不然为出错代码 参数： szCaptureName 所获取设备的名称； 第 44 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权全部 备注 当用户有多个视频采集设备（USB摄像头、虚拟摄像头、采集卡等）时，能够经过该方法选用指定的视频采集设备。 4.7.3. 获取当前视频采集设备 INT GetCurVideoCapture(CHAR* lpDeviceName, INT Len); 功能：获取当前使用的视频采集设备名称 返回值：0表示成功，不然为出错代码 参数： lpDeviceName 保存视频采集设备名称的缓冲区； dwLen 保存名称的缓冲区长度； 备注 缓冲区由外部分配，并经过dwLen参数传递缓冲区的大小。 4.7.4. 枚举本地音频采集设备 INT EnumAudioCapture(CHAR** lpDeviceName, INT& dwDeviceNum); 功能：枚举本地音频采集设备 返回值：0表示成功，不然为出错代码 参数： lpDeviceName 音频设备名称； dwDeviceNum 音频设备数量； 备注 该方法将会在内部分配缓冲区，外部使用完成以后，必需手工释放这些缓冲区，不然会形成内存泄露，因为内部采用了“GlobalAlloc”来分配高端内存，故外部须要调用“GlobalFree”来释放，而不能是delete或free方法，具体使用方法请参考Demo程序中的源代码。 第 45 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权全部 4.7.5. 选择指定的音频采集设备 INT SelectAudioCapture(STRING szCaptureName); 功能：选择指定的音频采集设备 返回值：0表示成功，不然为出错代码 参数： szCaptureName 所获取设备的名称； 备注 当用户有多个音频采集设备（板载声卡、USB声卡等）时，能够经过该方法选用指定的音频采集设备。 4.7.6. 获取当前音频采集设备 INT GetCurAudioCapture(CHAR* lpDeviceName, INT Len); 功能：获取当前使用的音频采集设备 返回值：0表示成功，不然为出错代码 参数： lpDeviceName 保存音频采集设备名称的缓冲区； dwLen 保存名称的缓冲区长度； 备注： 缓冲区由外部分配，并经过dwLen参数传递缓冲区的大小。 4.7.7. 获取音频设备的当前音量 INT AudioGetVolume(AudioDevice device, INT& dwVolume); 功能：获取指定音频设备的当前音量 返回值：0表示成功，不然为出错代码 参数： device 设备类型，定义为： 第 46 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权全部 AD_WAVEIN = 0, ///< 输入设备：Mic AD_WAVEOUT = 1, ///< 输出设备：Wave dwVolume 保存该设备的当前音量，取值范围：0~100； 备注 根据设备类型（device）参数的不一样，能够获取放音设备（WaveOut）和录音设备（WaveIn）的当前音量大小。 4.7.8. 设置指定音频设备的音量 INT AudioSetVolume(AudioDevice device, INT Volume); 功能：设置指定音频设备的音量 返回值：0表示成功，不然为出错代码 参数： device 设备类型，定义为： AD_WAVEIN = 0, ///< 输入设备：Mic AD_WAVEOUT = 1, ///< 输出设备：Wave dwVolume 须要设置的音量，取值范围：0~100，值越大，音量越大； 备注 根据设备类型（device）参数的不一样，能够调节放音设备（WaveOut）和录音设备（WaveIn）的音量大小。 4.7.9. SDK内核参数设置（整形值） int SetSDKOptionInt(int optname, int optvalue); 功能：SDK内核参数设置（整形值参数） 返回值：0表示成功，不然为出错代码 参数： optname 内核参数名称； optval 设置的参数值 第 47 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权全部 备注 能够经过该方法对AnyChat Core SDK内部的参数进行设置，实现特殊的功能要求。 目前提供的可设置内核参数名称代码见WIN32平台SDK相关定义。 4.7.10. SDK内核参数设置（字符串值） int SetSDKOptionString(int optname, String optvalue); 功能：SDK内核参数设置（字符串值参数） 返回值：0表示成功，不然为出错代码 参数： optname 内核参数名称； optval 设置的参数值 备注 能够经过该方法对AnyChat Core SDK内部的参数进行设置，实现特殊的功能要求。 目前提供的可设置内核参数名称代码见WIN32平台SDK相关定义。 4.7.11. SDK内核参数状态查询 int GetSDKOptionInt(int optname); 功能：SDK内核参数状态查询（整形值） 返回值：返回查询结果 参数： optname 内核参数名称； 备注 能够经过该方法对AnyChat Core SDK内部的参数进行状态查询，获取当前的设置。 String GetSDKOptionString(int optname); 第 48 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权全部 功能：SDK内核参数状态查询（字符串） 返回值：返回查询结果 参数： optname 内核参数名称； 备注 能够经过该方法对AnyChat Core SDK内部的参数进行状态查询，获取当前的设置。