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.audioFormatInteger否1音频驱动或交互时输入音频格式,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.成功,其他:失败