视频管理

设置视频参数

在发起或接听通话时，可通过 video 参数配置视频相关设置，包括摄像头、帧率和分辨率。

参数	类型	必填	说明
cameraId	string	否	摄像头的 deviceId
frameRate	RCFrameRate	是	帧率，默认值 'FPS_15'。
resolution	RCResolution	是	分辨率，默认值 ‘W640_H480’。

发起单人通话时设置

API 参考：call

typescript

const { code, session } = await caller.call({
    targetId: this.targetId,
    mediaType,
    listener: {
        ......
    },

    constraints: {
        // 视频参数设置
        video: {

            // 摄像头的deviceId, 以“xxxx”举例
            cameraId: "xxxx",

            // 默认帧率为 15
            frameRate: RCFrameRate.FPS_15,

            // 默认分辨率为 640 * 480
            resolution: RCResolution.W640_H480
        }

    }

});

发起多人通话时设置

API 参考：callInGroup

typescript

const { code, session } = await caller.callInGroup({
    targetId,
    mediaType,
    userIds,
    listener: {
     ......
    },

    constraints: {
        // 视频参数设置
       video: {

        // 摄像头的deviceId, 以“xxxx”举例
        cameraId: "xxxx",

        // 默认帧率为 15
        frameRate: RCFrameRate.FPS_15,

        // 默认分辨率为 640 * 480
        resolution: RCResolution.W640_H480
       }

    }

});

接听时设置

API 参考：accept

typescript

const { code } = await session.accept({
    // 视频参数设置
    video: {

        // 摄像头的deviceId, 以“xxxx”举例
        cameraId: "xxxx",

        // 默认帧率为 15
        frameRate: RCFrameRate.FPS_15,

        // 默认分辨率为 640 * 480
        resolution: RCResolution.W640_H480
    }

});

降级通话

提示

降级通话指从视频通话转为音频通话，目前仅支持视频往音频单向转换。

调用 session 对象的 descendability 方法可降级通话。

接口

JavaScript

session.descendAbility()

参数说明

无

示例代码

typescript

/**
 * 返回Promise<{code: RCCallErrorCode}>
 */
const { code } = await session.descendAbility()
if (code === RCCallErrorCode.SUCCESS) {
    // do something
}

禁用本地视频

调用 session 对象的 disableVideoTrack 方法可禁用本地视频。

接口

JavaScript

session.disableVideoTrack()

参数说明

无

示例代码

typescript

/**
 * 返回Promise<{code: RCCallErrorCode}>
 */
const { code } =await session.disableVideoTrack()
if (code === RCCallErrorCode.SUCCESS) {
    // do something
}

启用本地视频

调用 session 对象的 enableVideoTrack 方法可启用本地视频。

接口

JavaScript

session.enableVideoTrack()

参数说明

无

示例代码

typescript

/**
 * 返回Promise<{code: RCCallErrorCode}>
 */
const { code } = await session.enableVideoTrack()
if (code === RCCallErrorCode.SUCCESS) {
    // do something
}