说明
分2种情况:
1.假如是用户调用此接口实现语音对讲,则直接调用,直接用https
2.假如是设备调用此接口实现语音对讲,则暂时只支持http方式,端口用81
在您使用任何本文档所描述的HTTP API之前,您必须先获得使用HTTP API的授权。
语音对讲服务器授权的机制简单描述如下:
1) 在Request Headers的Cookie里添加,例如:
time=undefined; username=admin; user=admin; alias=admin; token=ZIK48H80V32Y17R0IBZA8F4P3AGCGF2F;
需要带上username和user,token信息
授权本身也是一个HTTP API,不过它与其它的API不同之处在于, Authorization Token是授权,而是通过检查您提交的用户名和密码来为Authorization Token。
假如是用户对讲
API URL
/intercom/talkback/talk_add.json
Request
Method:GET/POST
参数 | Value | 说明 |
---|---|---|
ip | [STRING] ,Required | 服务器的ip。 |
假如是设备对讲
API URL
/intercom/talkback/talk_add.json
Request
Method:GET/POST
参数 | Value | 说明 |
---|---|---|
username | [STRING] ,Required | 设备的名字,现在用的是序列号。 |
ip | [STRING] ,Required | 服务器的ip |
token | [STRING] ,Required | 设备的序列号 |
Response
格式(Example):
{
"result":"ok",
"data":{
"sdp":"v=0\r\no=- 1495799811084970 1495799811084970 IN IP4 192.168.2.112\r\ns=-\r\nt=0 0\r\na=group:BUNDLE audio\r\na=msid-semantic: WMS \r\nm=audio 1 RTP\/SAVPF 0\r\nc=IN IP4 0.0.0.0\r\na=mid:audio\r\na=sendrecv\r\na=rtcp-mux\r\na=ice-ufrag:h3ir\r\na=ice-pwd:090ssf9ozpisukrcdq1l58ap\r\na=ice-options:trickle\r\na=fingerprint:sha-256 43:0C:E5:B9:29:CA:3B:E2:E5:C9:36:44:3A:80:E8:C5:1F:F4:27:4F:12:00:47:4C:F7:83:77:E2:69:FA:77:77\r\na=setup:actpass\r\na=rtpmap:0 PCMU\/8000\/1\r\na=candidate:1 1 udp 12345678 192.168.2.112 59169 typ host\r\n",
"id":59169
}
}
Data字段说明:
Field | Value | 说明 |
---|---|---|
sdp | [STRING] | sdp信息 |
id | [INT] | 端口 |
一些建议:
1) 提醒您注意!没有释放接口,服务器会自动释放端口连接的用户和设备。