title: Conversation

一对一视频通话，实现一对一视频通话功能

属性

remoteUid

说明

获取当前一对一视频通话远端UID，此ID为不重复的字符串。


方法

accept

定义

  1. accept(localStream)

说明

被叫方接受主叫方的呼叫

参数

参数名 描述
localStream 接受邀请时携带的本地媒体流对象。

示例

  1. //接受邀请
  2. conversation.accept(localStream).then(function(conversation) {
  3.   //接受邀请，建立一对一视频通话，获取到Conversation
  4. });


reject

定义

  1. reject()

说明

拒绝邀请

示例

  1. //拒绝邀请
  2. conversation.reject();


close

定义

  1. close()

说明

挂断当前一对一视频通话

示例

  1. //离开一对一视频通话
  2. conversation.close();


常量

事件

事件类型 说明
response 一对一视频通话状态变化触发。
stream_received 收到远端媒体流触发。
closed Conversation 断开连接触发。
error Conversation 连接失败触发。
local_stats 获取本地媒体流统计信息。
remote_stats 获取远端媒体流统计信息。


response

参数

参数名 说明
callStatus String 类型。表示一对一视频通话的状态，包括已接受(ACCEPTED)、已拒绝(REJECTED)、对方忙碌(BUSY)、请求超时(TIMEOUT)。

示例

  1. //监听参与者加入失败事件
  2. conversation.on('response', function(callStatus){
  3.     switch (callStatus) {
  4.         case 'ACCEPTED':
  5.             console.log('accepted');
  6.             break;
  7.         case 'REJECTED':
  8.             console.log('rejected');
  9.             break;
  10.         case 'BUSY':
  11.             console.log('busy');
  12.             break;
  13.         case 'TIMEOUT':
  14.             console.log('timeout');
  15.             break;
  16.         default:
  17.             console.log('状态未识别');
  18.             break;
  19.     }
  20. });

stream_received

参数

参数名 说明
stream RemoteStream 类型远端参与者发送的媒体流

示例

  1. //监听远端参与者媒体流
  2. conversation.on('stream_received', function(stream){
  3.     console.log('remoteStream is :', stream);
  4. });

closed

示例

  1. //监听断开事件
  2. conversation.on('closed', function(){
  3.     console.log('Conversation disconnected.');
  4. });


error

示例

  1. //错误信息回调
  2. conversation.on('error', function(error){
  3.     console.log('Conversation error is' + error);
  4. });


local_stats

参数

参数名 说明
statistic 本地视频流统计信息，包括视频的宽、高、帧率、发送接收总大小、比特率等

示例

  1. //监听参与者加入事件
  2. conversation.on('local_stats', function(statistic){
  3.     console.log('local_stats is ' + statistic );
  4. });


remote_stats

参数

参数名 说明
statistic 对端视频流统计信息，包括视频的宽、高、帧率、发送接收总大小、比特率、延迟等

示例

  1. //监听参与者的断开事件
  2. conversation.on('remote_stats', function(statistic){
  3.     console.log('remote_stats is ' + statistic );
  4. });