实时音视频

  • 实时音视频 > 使用指南 > Linux >音视频采集

    音视频采集

    最近更新时间:2022-03-28 17:11:05

    音视频 track 为音视频交互的基本单位,本部分介绍音视频 track 的创建及采集等功能的使用。

    摄像头视频 Track

    QNCameraVideoTrack 为摄像头采集的本地 track,其创建方式如下:

    QNCameraVideoTrackConfig video_track_config;
    video_track_config.id = camera_device_id;
    video_track_config.capture_config = {width, height, fps};
    video_track_config.encoder_config = {width, height, fps, bitrate};
    QNCameraVideoTrack video_track = QNRTC::CreateCameraVideoTrack(video_track_config);
    

    其中:

    QNCameraVideoTrackConfig 用来配置摄像头采集参数和编码参数。

    在创建好 QNCameraVideoTrack 之后,就可以通过调用 SDK 提供的相关方法进行摄像头的相关操作:

    开启/关闭镜像

    virtual void SetMirror(bool mirror) = 0;
    

    外部导入视频 track

    SDK 外部导入视频连麦仅支持导入 kI420 数据 格式的数据,使用方式如下:

    创建外部导入视频 track

    QNCustomVideoTrack 为外部数据导入视频 track,创建方式如下:

    QNCustomVideoTrackConfig video_track_config;
    video_track_config.encoder_config = {width, height, fps, bitrate};
    QNCustomVideoTrack video_track = QNRTC::CreateCustomVideoTrack(video_track_config);
    

    其中,QNCustomVideoTrackConfig 用来配置视频的编码参数,包括分辨率、帧率和码率(kbps)等。

    数据导入

    导入 I420 数据

    SDK 支持导入 I420 的数据,在创建好 QNCustomVideoTrack 之后,可通过如下方式推送数据:

      /**
       * 推送自定义视频帧
       *
       * @param data 视频数据
       * @param data_size 数据长度
       * @param width 图像宽度
       * @param height 图像高度
       * @param timestamp_us 时间戳,注意单位为:微妙
       * @param video_frame_type 视频原始格式,目前支持:kI420
       * @param rotation 导入后旋转角度,如果不需要旋转则使用默认值 kVideoRotation0
       * 即可
       * @param mirror 导入后是否镜像
       */
      virtual int32_t PushVideoFrame(const uint8_t* data, const uint32_t data_size,
                                     const int32_t width, const int32_t height,
                                     const int64_t timestamp_us,
                                     QNVideoFrameType video_frame_type,
                                     QNVideoRotation rotation,
                                     bool mirror = false) = 0;
    

    麦克风音频 Track

    QNMicrophoneAudioTrack 为麦克风采集的音频 track,如需以麦克风采集数据作为音频源,仅需创建一个 QNMicrophoneAudioTrack 并发布即可,其创建方式如下:

    QNMicrophoneAudioTrackConfig audio_track_config;
    audio_track_config.audio_quality = {sample_rate, channels, bits_per_sample, bitrate};
    QNMicrophoneAudioTrack audio_track = QNRTC::CreateMicrophoneAudioTrack(audio_track_config);
    

    其中,QNMicrophoneAudioTrackConfig 包括音频的码率等,这里麦克风的采样率、声道数等由系统录制设备控制

    注意:SDK 当前仅支持一路音频 Track,因此,在创建了 QNMicrophoneAudioTrack 之后,将无法再创建 QNCustomAudioTrack 实例

    外部导入音频 Track

    QNCustomAudioTrack 为外部导入音频 track,如需导入音频数据作为音频源,仅需创建一个 QNCustomAudioTrack 即可,然后通过调用 QNCustomAudioTrack.PushAudioFrame 进行外部音频数据的导入。

    支持的音频数据格式为:PCM 格式。

    使用方式可参考如下示例:

      /**
       * 推送自定义音频帧
       *
       * @param data 音频数据
       * @param data_size 数据长度
       * @param bits_per_sample 位宽,即每个采样点占用位数
       * @param sample_rate 采样率
       * @param channels 声道数
       */
      virtual int32_t PushAudioFrame(const uint8_t* data, uint32_t data_size,
                                     uint32_t bits_per_sample, uint32_t sample_rate,
                                     uint32_t channels) = 0;
    

    注意:SDK 当前仅支持一路音频 Track,因此,在创建了 QNCustomAudioTrack 之后,将无法再创建 QNMicrophoneAudioTrack 实例

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