API 接口

WebRTC 协商、文本驱动、视频切换与录像控制接口。

5. api接口

客户端通过http post请求与后台交互

5.1 获取视频

接口说明： 协商获取webrtc视频
接口地址： /offer

5.1.1 请求参数

paramter	type	required	desc
type	string	Y	填offer
sdp	string	Y	webrtc请求参数
avatar	string	N	avatarid,默认值用命令启动参数里的avatar_id
refaudio	string	N	克隆音色id，默认值用命令启动参数里的REF_FILE
reftext	string	N	克隆音色文本，默认值用命令启动参数里的REF_TEXT
custom_config	string	N	动作编排配置json字符串，默认值用命令启动参数里的customvideo_config

请求示例：

{
    ‘sdp’: ‘xxxx’,
    ‘type’: 'offer',
}

5.1.2 返回数据

paramter	type	required	desc
type	string	Y	填answer
sdp	string	Y	webrtc应答参数
sessionid	string	Y	数字人会话id，用于区分多路数字人。后面的接口都需要用该参数

返回示例：

{
    ‘sdp’: ‘xxxx’,
    ‘type’: 'answer',
    ‘sessionid’: 'd39256ea-c017-4cdc-8d4b-b73fd246d95f',
}

5.2 发送文字

接口说明： 向数字人发送聊天内容
接口地址： /human

5.2.1 请求参数

paramter	type	required	desc
sessionid	string	Y	数字人会话id
interrupt	bool	N	是否打断数字人当前说话，默认为false
type	string	Y	echo：数字人播报输入文字；chat：与数字人对话
text	string	Y	文字内容

请求示例：

{
    ‘text’: ‘hello’,
    ‘type’: 'echo',
    ‘interrupt’: true,
    ‘sessionid’:'d39256ea-c017-4cdc-8d4b-b73fd246d95f'
}

5.3 切换播放视频

接口说明： 控制数字人播放自定义视频
接口地址： /set_audiotype

5.3.1 请求参数

paramter	type	required	desc
sessionid	string	Y	数字人会话id
audiotype	int	Y	播放的视频内容，与后台自定义视频对应

请求示例：

{
    ‘audiotype’: 2,
    ‘sessionid’:'d39256ea-c017-4cdc-8d4b-b73fd246d95f'
}

5.4 录像

接口说明： 在服务端保存数字人录像,文件地址data/record.mp4
接口地址： /record

5.4.1 请求参数

paramter	type	required	desc
sessionid	string	Y	数字人会话id
type	string	Y	start_record:开始录像; end_record:停止录像

请求示例：

{
    ‘type’: 'start_record',
    ‘sessionid’:'d39256ea-c017-4cdc-8d4b-b73fd246d95f'
}

5.5 打断数字人说话

接口说明： 打断数字人说话
接口地址： /interrupt_talk

5.5.1 请求参数

paramter	type	required	desc
sessionid	string	Y	数字人会话id

请求示例：

{
    ‘sessionid’:'d39256ea-c017-4cdc-8d4b-b73fd246d95f'
}

第三方软件对接流程

pc = new RTCPeerConnection();
var offer = pc.localDescription;
调用api /offer接口，传入参数为offer.sdp, offer.type。获取返回数据answer
pc.setRemoteDescription(answer) #将返回数据设置到pc中，后面就能接收到视频。 此部分具体代码参考web/client.js

调用api /human接口, sessionid为answer.sessionid。驱动数字人说话