Skip to content

设置虚拟人参数

方法名

createAvatarParams

用法

  • 用法如下:
    js
    module.createAvatarParams({
      params: {
        //虚拟人信息
        avatar: {
          avatarId: "201343001",
          bgData: "http://ceph.xfyousheng.com/J9Q7O4EL/uploadResource/20210315/3f8cda6a-3d43-46ff-965a-f34df51b36f0.jpg",
          scale: 0.95,
          moveH: 0,
          moveV: 0,
          width: 1080,
          height: 1920,
          audioFormat: 1,
          maskRegion: "",
          bgType: "url",
          //设置Stream参数
          stream: {
            protocol: "xrtc",
            alpha: false,
            bitrate: 2000,
            fps: 25,
          }
        },
        tts: {
          vcn: "x4_yezi",
          speed: 50,
          pitch: 50,
          volume: 50
        },
        subtitle: {
          enable: false,
          fontColor: "#FFFFFF"
        },
        dispatch: {
          interactiveMode: 0,
          contentAnalysis: 0
        },
        scene: {
          sceneId: "320726603397206016",
          sceneVersion: ""
        },
        vc: {
          vc: 0,
          voiceName: "chongchong"
        },
        stream: "xrtc",
        videoWidth: 1080,
        videoHeight: 1920,
        renderTimeout: 5000
      },
      complete: (res) => {
        // console.log(res)
      }
    })
    js
    module.createAvatarParams({
      params: {
        //虚拟人信息
        avatar: {
          avatarId: "201343001",
          bgData: "http://ceph.xfyousheng.com/J9Q7O4EL/uploadResource/20210315/3f8cda6a-3d43-46ff-965a-f34df51b36f0.jpg",
          scale: 0.95,
          moveH: 0,
          moveV: 0,
          width: 1080,
          height: 1920,
          audioFormat: 1,
          maskRegion: "",
          bgType: "url",
          //设置Stream参数
          stream: {
            protocol: "xrtc",
            alpha: false,
            bitrate: 2000,
            fps: 25,
          }
        },
        tts: {
          vcn: "x4_yezi",
          speed: 50,
          pitch: 50,
          volume: 50
        },
        subtitle: {
          enable: false,
          fontColor: "#FFFFFF"
        },
        dispatch: {
          interactiveMode: 0,
          contentAnalysis: 0
        },
        scene: {
          sceneId: "320726603397206016",
          sceneVersion: ""
        },
        vc: {
          vc: 0,
          voiceName: "chongchong"
        },
        stream: "xrtc",
        videoWidth: 1080,
        videoHeight: 1920,
        renderTimeout: 5000
      },
      complete: (res : LevenResult) => {
        console.log(res)
      }
    } as LevenOptions)
  • 参数说明
    参数名参数类型是否必填默认值参数描述
    paramsObject接口请求参数
    params.avatarObject虚拟人信息
    params.avatar.avatarIdString虚拟人id
    params.avatar.avatarImgUrlString官方文档未做说明
    params.avatar.avatarImgEncodeString官方文档未做说明
    params.avatar.anchorTypeString官方文档未做说明
    params.avatar.bgTypeString背景类型,当前仅支持res_key
    params.avatar.bgDataString背景数据,type为res_key,data传入图片id,背景可在虚拟人交互平台-素材管理中进行上传,上传后生成res_id 。地址:https://virtual-man.xfyun.cn/console/assetsManagement
    params.avatar.audioFormatInteger1音频驱动或交互时输入音频格式,1-采样率16000,2-采样率24000,默认1
    params.avatar.bgScaleTypeString背景裁剪类型,可选值:FIT_XY FIT_CENTER
    params.avatar.bsDimInteger官方文档未做说明
    params.avatar.heightInteger视频高,默认1080,需是4的倍数
    params.avatar.widthInteger视频宽,默认720,需是4的倍数
    params.avatar.maskRegionString虚拟人裁剪信息,形式:【x,y,m,n】
    params.avatar.moveHInteger水平位移,相对于中心位置,默认0
    params.avatar.moveVInteger竖直位移,相对于中心位置,默认0
    params.avatar.scaleFloat虚拟人缩放比例,默认1.0 ,取值范围(0-1.0】
    params.avatar.streamObject视频流信息
    params.avatar.stream.protocolString视频流协议,目前支持xrtc
    params.avatar.stream.alphaInteger是否带透明通道,0-无,1-开启,设置为1的时候,背景设置将不起作用
    params.avatar.stream.bitrateInteger视频码率,单位kbps,默认2000
    params.avatar.stream.fpsInteger视频帧率,目前支持15,20,25;默认25
    params.avatar.vadModeInteger官方文档未做说明
    params.ttsObject语音合成相关参数
    params.tts.audioObject语音合成音频信息
    params.tts.audio.sampleRateInteger语音合成音频采样率,不同的发音人支持不一样,详情请咨询技术支持,默认16000
    params.tts.volumeInteger语音合成音量,取值0-100,默认50
    params.tts.engineTypeString官方文档未做说明,可选值:XTTS_MULTI XTTS_PUBLIC
    params.tts.languageInteger官方文档未做说明
    params.tts.pitchInteger语音合成语调,取值0-100,默认50
    params.tts.speedInteger语音合成语速,取值0-100,默认50
    params.tts.vcnString语音合成发音人,不传时将使用虚拟人对应的默认发音人
    params.vcObject变声相关参数
    params.vc.vcInteger是否开启变声,0-关闭,1-开启,默认关闭
    params.vc.voiceNameString开启变声后,需要传入变声发音人
    params.subtitleObject字幕相关参数
    params.subtitle.enableInteger是否字幕,0-关闭,1-开启,默认关闭
    params.subtitle.fontColorString字幕颜色,默认#ffffff
    params.sceneObject场景参数
    params.scene.sceneIdString场景id,来自虚拟人交互平台配置系统
    params.scene.sceneVersionString场景版本,来自虚拟人交互平台配置系统
    params.dispatchObject交互模式
    params.dispatch.audioModeInteger音频类型:0-非实时音频(如文件)1-实时音频,默认实时音频
    params.dispatch.contentAnalysisInteger文本情感分析,0-关闭 1-开启 ,默认关闭
    params.dispatch.interactiveModeInteger交互模式:0-追加 1-打断 默认追加模式,当前仅在文本驱动场景生效
    params.dispatch.targetTypeString官方文档未做说明
    params.asrObject识别相关参数
    params.asr.fullDuplexInteger是否为全双工交互,0-否 1-是,默认否,如需使用手机自带的AEC功能进行回声消除,需要将播放器音频播放类型设置为AudioManager.STREAM_VOICE_CALL,同时录音源设置为MediaRecorder.AudioSource.VOICE_COMMUNICATION,同时将录音器的SessionId设置到播放器中
    params.airObject动作相关参数
    params.air.airInteger是否开启自动动作,开启后会根据播报文本内容自动选择该虚拟人相应的动作,0-关闭 1-开启,默认关闭
    params.air.addNonSemanticInteger是否在间隔过长的动作间插入无指向动作,0-关闭 1-开启
    successFunction执行成功的函数
    failFunction执行失败的函数
    completeFunction执行完成的函数,不管成功还是失败都会执行

回调

  • 示例
    json
    {
      "data": {
        "type": "onCreate"
      },
      "message": "",
      "code": 0
    }
  • 回调说明:
    参数名参数类型参数描述
    messageString消息提示
    dataObject数据对象
    data.typeString操作类型:具体类型如下:
    onCreate:接口调用成功
    onResult:监听结果
    onEvent:监听事件
    onError:错误事件
    data.dataTypeString数据类型,具体可参考官方文档onResult类型中返回
    data.extraString数据附加信息
    data.eventTypeString事件类型,onEvent类型中返回
    data.errorCodeString错误码,onError类型中返回
    data.errorDescString错误描述,onError类型中返回
    codeInteger返回类型,0.成功,其他:失败