实时音视频

    • 实时音视频 > API 文档 > Android >QNScreenVideoTrack

    QNScreenVideoTrack

    最近更新时间: 2023-04-21 12:45:50

    本地视频录屏 Track 类，可通过 QNRTC.createScreenVideoTrack 方式创建该 Track 对象

    屏幕录制 Track 的创建需要发起系统屏幕录制的申请，具体使用姿势请参考屏幕录制 Track 使用指南。

    Hierarchy
    Index
    Core Methods
    Core Methods
    getTrackID
    • String getTrackID()

    • 获取 TrackID，仅当发布成功后，才可以获取到有效的 TrackID

      Returns String
    getUserID
    • String getUserID()

    • 获取 UserID

      Returns String
    getTag
    • String getTag()

    • 获取 Tag

      Returns String
    isAudio
    • boolean isAudio()

    • 是否为音频 Track

      Returns boolean
    isVideo
    • boolean isVideo()

    • 是否为视频 Track

      Returns boolean
    isMuted
    • boolean isMuted()

    • 该 Track 是否处于静默状态

      Returns boolean
    setMuted
    • void setMuted(boolean muted)

    • 设置是否静默该 track，静默后，SDK 将会发送静默帧数据

      当静默状态改变后，远端用户将会收到 QNTrackInfoChangedListener.onMuteStateChanged 的回调

      Parameters
      • muted: boolean

        是否静默

    destroy
    • void destroy()

    • 销毁本地创建的 Track

    sendSEI[1/4]
    • void sendSEI(String message, int repeatCount)

    • 发送 SEI 信息

      1. SEI 信息会携带到视频的编码数据中，在 CDN 转推 场景下，Track 处于正常发布状态时，调用该接口后，观众端即可使用支持解析 SEI 的播放器来获取对应的 SEI 信息。

      2. 单路流转推和多路流合流转推在发送 SEI 信息的使用姿势上存在差异，详情可参考 SEI 发送指南

      该接口已废弃, 请使用 int sendSEI(byte[] message, int repeatCount)

      Parameters
      • message: String

        消息内容

      • repeatCount: int

        重复次数，-1 为每一帧都发送

    sendSEI[2/4]
    • void sendSEI(String message, byte[] uuid, int repeatCount)

    • 发送 SEI 信息

      1. SEI 信息会携带到视频的编码数据中，在 CDN 转推 场景下，Track 处于正常发布状态时，调用该接口后，观众端即可使用支持解析 SEI 的播放器来获取对应的 SEI 信息。

      2. 单路流转推和多路流合流转推在发送 SEI 信息的使用姿势上存在差异，详情可参考 SEI 发送指南

      该接口已废弃, 请使用 int sendSEI(byte[] message, byte[] uuid, int repeatCount)

      Parameters
      • message: String

        消息内容

      • uuid: byte[]

        唯一 ID；必须为 16 个字节

      • repeatCount: int

        重复次数，-1 为每一帧都发送

    sendSEI[3/4]
    • int sendSEI(byte[] message, int repeatCount)

    • 发送 SEI

      1. SEI 信息会携带到视频的编码数据中，在 CDN 转推 场景下，Track 处于正常发布状态时，调用该接口后，观众端即可使用支持解析 SEI 的播放器来获取对应的 SEI 信息。

      2. 单路流转推和多路流合流转推在发送 SEI 信息的使用姿势上存在差异，详情可参考 SEI 发送指南

      Parameters
      • message: byte[]

        消息内容；最多为 4096 字节

      • repeatCount: int

        重复次数

      Returns 调用返回值，详见 QNErrorCode
    sendSEI[4/4]
    • int sendSEI(byte[] message, byte[] uuid, int repeatCount)

    • 发送 SEI

      1. SEI 信息会携带到视频的编码数据中，在 CDN 转推 场景下，Track 处于正常发布状态时，调用该接口后，观众端即可使用支持解析 SEI 的播放器来获取对应的 SEI 信息。

      2. 单路流转推和多路流合流转推在发送 SEI 信息的使用姿势上存在差异，详情可参考 SEI 发送指南

      Parameters
      • message: byte[]；最多为 4096 字节

        消息内容

      • uuid: byte[]

        唯一 ID；必须为 16 个字节

      • repeatCount: int

        重复次数

      Returns 调用返回值，详见 QNErrorCode
    setVideoEncoderConfig
    • void setVideoEncoderConfig(QNVideoEncoderConfig config)

    • 动态修改视频 Track 的编码参数（分辨率、帧率、码率等）

      1. 该接口用于在通话过程中动态修改视频的编码参数，若您无需修改，可在创建视频 Track 时通过对应的 TrackConfig 直接指定编码参数

      2. 建议修改时目标编码分辨率小于采集的分辨率。当目标编码分辨率大于采集分辨率时，SDK 会基于采集分辨率裁剪输出一个和目标编码分辨率宽高比相匹配，但小于等于采集分辨率的参数

      Parameters
    setVideoFrameListener
    • void setVideoFrameListener(QNVideoFrameListener listener)

    • 设置视频数据监听

      Parameters
      • listener: QNVideoFrameListener

        视频数据监听接口

    play
    requestPermission
    • static boolean requestPermission(Activity activity)

    • 请求录屏权限，成功发起申请返回成功，否则返回失败

      在 API < 21 的时候会返回失败，Android 从 API 21 才开始支持录屏

      Parameters
      • activity: Activity

        Android Activity 对象

      Returns boolean
    isScreenCaptureSupported
    • static boolean isScreenCaptureSupported()

    • 当前设备是否支持屏幕采集

      Returns boolean
    checkActivityResult
    • static boolean checkActivityResult(int requestCode, int resultCode, Intent data)

    • 处理权限请求返回的结果

      1. 请先重写 (Override) Activity 中的 onActivityResult 方法

      2. 若监听到 requestCode 等于 QNScreenCaptureUtil.SCREEN_CAPTURE_PERMISSION_REQUEST_CODE 则证明本次回调包含申请屏幕录制的结果，此时可调用本方法将参数传入 SDK，SDK 将判断用户是否授权屏幕录制

      3. 若本接口调用返回 true，则代表用户同意屏幕录制，此时创建屏幕录制 Track 即可

      Parameters
      • requestCode: int

        请求 code

      • resultCode: int

        权限请求返回的 code

      • data: Intent

        权限请求返回的数据

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