human: 如何处理七牛云的实时音视频QNRTC

gpt: [实时音视频](https://developer.qiniu.com/rtc) > API 文档 > Uniapp >QNRTC

#  QNRTC

最近更新时间: 2023-12-11 15:57:08

Index

Method

  * configRTC
  * createAudioEffectMixer
  * createAudioMusicMixer
  * createCameraVideoTrack
  * createClient
  * createMicrophoneAudioTrack
  * createScreenVideoTrack
  * deinit
  * enableFileLogging
  * init
  * isScreenCaptureSupported
  * off
  * on
  * requestPermission
  * setAudioRouteToSpeakerphone
  * setAudioScene
  * setLogConfig
  * setSpeakerphoneMuted
  * uploadLog

Method

Static configRTC

  * configRTC(config: [QNRTCConfiguration](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11385/UniappQNRTCConfiguration)): void
  * 初始化 SDK

> 必须在使用其它接口前调用

Parameters

    * config: [QNRTCConfiguration](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11385/UniappQNRTCConfiguration)

初始化配置项

Returns void

Static createAudioEffectMixer

  * createAudioEffectMixer(): [QNAudioEffectMixer](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12611/UniappQNAudioEffectMixer)
  * 创建音效混音控制器对象

> 音效混音支持同时混合多路音效文件

Returns
[QNAudioEffectMixer](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12611/UniappQNAudioEffectMixer)

Static createAudioMusicMixer

  * createAudioMusicMixer(url: string): [QNAudioMusicMixer](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12610/UniappQNAudioMusicMixer)
  * 创建背景音乐混音控制器对象

> 仅支持在线文件，支持的文件格式为：aac、mp3、mp4、ogg、opus、wav、m4a、flac
> 1.背景音乐混音仅支持同时混合一路背景音乐，若需要切换背景音乐，重新调用本接口创建 {@link QNAudioMusicMixer} 即可
> 2.建议使用本地文件进行混音，以避免网络环境差引起的混音异常 3.若您希望在混合背景音乐的同时添加音效，可参考音效混音相关接口({@link
> QNAudioEffectMixer})

Parameters

    * url: string 

音频文件路径

Returns
[QNAudioMusicMixer](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12610/UniappQNAudioMusicMixer)

Static createCameraVideoTrack

  * createCameraVideoTrack(config: [QNCameraVideoTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11394/UniappQNCameraVideoTrackConfig)): [QNCameraVideoTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11433/UniappQNCameraVideoTrack)
  * 创建摄像头视频轨

> 默认 tag 为 ""

Parameters

    * config: [QNCameraVideoTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11394/UniappQNCameraVideoTrackConfig)

摄像头 Track 的配置，可设置视频的采集配置、编码配置等

Returns
[QNCameraVideoTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11433/UniappQNCameraVideoTrack)

Static createClient

  * createClient(config: [QNClientConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12607/UniappQNClientConfig)): [QNRTCClient](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11402/UniappQNRTCClient)
  * 创建 QNRTCClient 对象

> 全局只可存在一个

Parameters

    * config: [QNClientConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12607/UniappQNClientConfig)

Returns
[QNRTCClient](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11402/UniappQNRTCClient)

Static createMicrophoneAudioTrack

  * createMicrophoneAudioTrack(config: [QNMicrophoneAudioTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11431/UniappQNMicrophoneAudioTrackConfig)): [QNMicrophoneAudioTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11388/UniappQNMicrophoneAudioTrack)
  * 创建麦克风音频轨

> 默认 tag 为 ""

Parameters

    * config: [QNMicrophoneAudioTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11431/UniappQNMicrophoneAudioTrackConfig)

采集音频的配置，可指定音频质量等级与开关通讯模式

Returns
[QNMicrophoneAudioTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11388/UniappQNMicrophoneAudioTrack)

Static createScreenVideoTrack

  * createScreenVideoTrack(config: [QNScreenVideoTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11434/UniappQNScreenVideoTrackConfig)): [QNScreenVideoTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11421/UniappQNScreenVideoTrack)
  * 创建屏幕录制轨

> 默认 tag 为 ""

Parameters

    * config: [QNScreenVideoTrackConfig](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11434/UniappQNScreenVideoTrackConfig)

屏幕录制 Track 的配置，可设置视频的编码配置与开关大小流功能

Returns
[QNScreenVideoTrack](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11421/UniappQNScreenVideoTrack)

Static deinit

  * deinit(): void
  * 反初始化操作

> 在确认不再使用实时音视频后调用此接口释放其占用的资源，此后如果再使用需要再次调用 configRTC 方法

Returns void

Static enableFileLogging

  * enableFileLogging(): void
  * 设置是否开启本地日志保存

> 设置是否开启本地日志保存

Returns void

Static init

  * init(config: [QNRTCConfiguration](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11385/UniappQNRTCConfiguration)): void
  * 初始化 SDK

> 必须在使用其它接口前调用

Parameters

    * config: [QNRTCConfiguration](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11385/UniappQNRTCConfiguration)

初始化配置项

Returns void

Static isScreenCaptureSupported

  * isScreenCaptureSupported(): number
  * 判断屏幕录制功能是否可用

> 建议创建 QNScreenVideoTrack 前先调用次接口确认是否支持录屏

Returns number

Static off

  * off(name: event, listener: [QNRTCEngineEvent](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11413/UniappQNRTCEngineEvent)[event]): void
  * 取消监听对应的事件

Parameters

    * name: event 

事件名

    * listener: [QNRTCEngineEvent](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11413/UniappQNRTCEngineEvent)[event] 

事件句柄

Returns void

Static on

  * on(name: event, listener: [QNRTCEngineEvent](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11413/UniappQNRTCEngineEvent)[event]): void
  * 监听对应的事件

> 支持多次调用同一事件

Parameters

    * name: event 

事件名

    * listener: [QNRTCEngineEvent](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11413/UniappQNRTCEngineEvent)[event] 

事件句柄

Returns void

Static requestPermission

  * requestPermission(callback: [QNScreenPermissionResultCallback](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11575/UniappQNScreenPermissionResultCallback)): void
  * 请求录屏权限

> 只支持安卓，创建 QNScreenVideoTrack 前安卓需要调用此接口获取对应权限

Parameters

    * callback: [QNScreenPermissionResultCallback](https://developer.qiniu.com/rtc/11415/UniappQNRTC/11575/UniappQNScreenPermissionResultCallback)

请求录屏权限后回调

Returns void

Static setAudioRouteToSpeakerphone

  * setAudioRouteToSpeakerphone(audioRouteToSpeakerphone: boolean): void
  * 音频路由切换

> 设置是否将音频路由切换到扬声器，默认音频路由为扬声器

Parameters

    * audioRouteToSpeakerphone: boolean 

初始化配置项

Returns void

Static setAudioScene

  * setAudioScene(audioScene: [QNAudioScene](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12608/UniappQNAudioScene)): void
  * 切换音频场景

> 音频场景包括 DEFAULT、VOICE_CHAT 和 SOUND_EQUALIZE 三种，不同场景下，设备的音量类型存在差异，其中： 1\.
> DEFAULT 场景会根据发布和订阅的情况自动切换音频模式，仅发布或仅订阅时，SDK 使用媒体模式；同时发布和订阅时，SDK 将自动切换到通话模式
> 2\. VOICE_CHAT 场景恒定使用通话模式，调节的音量类型为通话音量 3\. SOUND_EQUALIZE
> 场景恒定使用媒体模式，调节的音量类型为媒体音量 4\. 佩戴蓝牙耳机的场景，将恒定使用通话模式，在蓝牙通话过程中修改的音频场景将会在蓝牙连接断开后生效
> 5\. 佩戴有线耳机的场景，将恒定使用媒体模式，在通话过程中修改的音频场景将会在耳机拔出后生效

Parameters

    * audioScene: [QNAudioScene](https://developer.qiniu.com/rtc/11415/UniappQNRTC/12608/UniappQNAudioScene)

Returns void

Static setLogConfig

  * setLogConfig(): void
  * 设置日志

Returns void

Static setSpeakerphoneMuted

  * setSpeakerphoneMuted(muted: boolean): void
  * 设置是否静音扬声器

> 静音后将听不到远端用户的声音。默认为 false

Parameters

    * muted: boolean 

是否静音扬声器

Returns void

Static uploadLog

  * uploadLog(): void
  * 上传日志

Returns void

以上内容是否对您有帮助？