实时音视频

  • 实时音视频 > API 文档 > Android >API 概览

    API 概览

    最近更新时间: 2024-02-23 18:34:17

    QNDroidRTC 是七牛推出的一款适用于 Android 平台的音视频通话 SDK,提供了包括美颜、滤镜、音视频通话等多种功能,提供灵活的接口,支持高度定制以及二次开发,您可以很方便地在 Android 平台上开发出一款基于实时音视频的应用。

    本文档适用于 QNDroidRTC 4.x 版本的 SDK,并不向下兼容。

    QNDroidRTC 4.x 是在 3.x 的基础上进行了 API 的重构和优化,从而使使用者能够更加高效的接入,所以新接入的用户推荐使用最新版本的 SDK。

    老用户也可以继续使用 QNDroidRTC 3.x 版本,我们也会持续在此版本上进行问题修复和版本更迭,但是后续的一些新功能有可能并不会在 3.x 版本上提供。若您决定继续使用 3.x 版本 SDK,则可参考 3.x 及之前版本的相关文档

    使用 3.x 或者更低版本的用户若想升级至 v4.x 版本,可参考 4.x 版本迁移指南 进行升级

    QNRTC

    QNRTC 提供 SDK 的入口方法,可以通过它进行 SDK 的初始化,各个类型 Track 的创建等操作。其核心方法如下:

    初始化与反初始化

    方法 描述
    init 初始化 SDK
    deinit 反初始化 SDK

    创建 Track

    方法 描述
    createMicrophoneAudioTrack 创建麦克风音频轨道
    createCameraVideoTrack 创建摄像头视频轨道
    createScreenVideoTrack 创建屏幕采集的视频轨道
    createCustomAudioTrack 创建自定义导入音频数据轨道
    createCustomVideoTrack 创建自定义导入视频数据轨道

    音频播放路由

    方法 描述
    setAudioRouteToSpeakerphone 设置默认音频播放路由为扬声器
    QNRTCClient

    QNRTCClient 提供和房间相关的一些列方法,通过它我们可以实现加入房间,在房间内发布或者订阅相应的音视频轨道等操作。主要的核心方法如下:

    核心方法

    方法 描述
    join 加入房间
    leave 离开房间
    publish 发布本地的音视频轨道
    unpublish 取消发布本地的音视频轨道
    subscribe 订阅远端用户发布的音视频轨道
    unsubscribe 取消订阅远端用户发布的音视频轨道

    CDN 转推

    方法 描述
    startLiveStreaming 开始单路转推或者合流转推
    stopLiveStreaming 停止单路转推或者合流转推
    setTranscodingLiveStreamingTracks 更新合流转推的布局配置
    removeTranscodingLiveStreamingTracks 移除合流转推的布局配置
    setLiveStreamingListener 设置转推相关事件的监听器

    跨房媒体转发

    方法 描述
    startMediaRelay 开启跨房媒体转发
    updateMediaRelay 更新跨房媒体转发状态
    stopMediaRelay 停止跨房媒体转发
    QNLocalTrack

    QNLocalTrack 是本地创建的一个音频或者视频轨道,可以通过 QNRTC 来创建各种类型的音视频轨道,例如麦克风采集的音频轨道,摄像头采集的视频轨道,或者屏幕采集的视频轨道等等,我们真正用到的是它所衍生的子类。

    以 QNLocalTrack 为基类,向下衍生的子类如下:

    Hierarchy
    • 本地音频轨道 描述
      QNMicrophoneAudioTrack 以麦克风采集到的音频数据为数据源创建的音频轨道,提供了音量控制,播放,数据回调等接口,通过 QNRTC.createMicrophoneAudioTrack 创建。
      QNCustomAudioTrack 以外部导入的 PCM 音频数据为数据源创建的音频轨道,可以通过 pushAudioFrame 方法向房间内推送数据,通过 QNRTC.createCustomAudioTrack 创建。
      本地视频轨道 描述
      QNCameraVideoTrack 以摄像头采集到的视频数据为数据源创建的视频轨道,提供了包括摄像头采集,渲染播放,前后摄像头切换,开启闪光灯,设置曝光度等一系列操作摄像头的方法。通过 QNRTC.createCameraVideoTrack 创建。
      QNScreenVideoTrack 以屏幕采集到的视频数据为数据源创建的视频轨道,提供屏幕录制的权限申请等一些列方法,通过 QNRTC.createScreenVideoTrack 创建。
      QNCustomVideoTrack 以外部导入的 NV21 格式的视频数据或者纹理数据为数据源创建的音频轨道,可以通过 pushVideoFrame 方法往房间内推送视频数据,通过 QNRTC.createCustomVideoTrack 创建。
    QNRemoteTrack

    QNRemoteTrack 是远端用户创建的音视频轨道,本地用户可以通过房间中的事件回调获取。其衍生的子类如下:

    Hierarchy
    • 远端音视频轨道 描述
      QNRemoteAudioTrack 远端用户发布的音频轨道,可以通过该类来调节、获取播放音量的大小,同时还提供了音频数据回调等。
      QNRemoteVideoTrack 远端用户发布的视频轨道,可以通过该类来把远端视频画面渲染到视图中,同时还提供了视频数据回调等。
    QNClientEventListener

    房间内的事件可以通过该接口类进行监听,在调用 QNRTC.createClient 方法创建 QNClient 的时候,可以把 QNClientEventListener 作为参数传入。其提供的主要回调方法如下:

    事件监听

    SDK 支持丰富的事件监听接口,不同场景下的事件监听接口定义如下:

    以上内容是否对您有帮助?
  • Qvm free helper
    Close