SIP.js 软电话

迷途橘

2021 年 12 月 15 日

21 次浏览

暂无评论

2913字数

js 小方法

## 初始化

### 创建UA对象

```js
const myUA = new SIP.UA(initialConfig)
```

initialConfig 配置

```js
{
  uri: 'sip:sip.com',
  wsServers: 'wss:sip.com:7443',
  authorizationUser: 'webrtc', // 授权号
  displayName: 'webrtc', // 显示名称
  password: '888888', // 登陆密码
  allowLegacyNotifications: true,  //允许语言通知 
  autostart: true, // 自动连接
  register: false, // 自动就绪
  rel100: SIP.C.supported.SUPPORTED, // 该选项开启接收早期媒体(采坑记录)
}
```

### 注册UA

```js
myUA.register({
  register: true
})
```

### 注册钩子事件

```js
myUA.on('connected', function() {
  console.log("-------已连接--------")
})

myUA.on('disconnected', function() {
  console.log("-------未连接--------")
})

myUA.on('registered', function() {
  console.log("--------已注册-------")
})

myUA.on('unregistered', function() {
  console.log("------未注册--------")
})

myUA.on('registrationFailed', function() {
  console.log("-----SIP注册失败-------")
})

myUA.on('disconnected', function() {
  console.log("-----websocket连接失败-------")
})

myUA.on("invite", function( invitation ) {
  console.log("-----有电话呼入-------")
})
```

## 我方拨打

### 拨打电话

调用实例的invite方法，传入要拨打的手机号和通话配置，进行拨打电话

```js
currentCall = myUA.invite(phoneNumber, callConfig)
```

callConfig 通话配置

```js
{
  media: {
    constraints: {
      audio: true,  // 是否开启音频
      video: false  // 是否开启视频
    },
    render: {
      remote: document.getElementById('')  //  音频挂载点，它是一个audio标签
    }
  },
  extraHeaders: ['X-callUUID']  // 请求头
}
```

> phoneNumber   要拨打的手机号
> X-callUUID    唯一ID
> currentCall   当前通话实例

### 通话回调事件

```js
// 对方拒接电话
currentCall.on("rejected", ()=> {

})

// 本次通话结束
currentCall.on("bye", ()=> {

})

// 对方接听电话
currentCall.on("accepted", ()=> {

})

// 我方取消通话
currentCall.on("cancel", ()=> {

})
```

### 挂断
```js
if (!currentCall) {
  return
} else if (currentCall.startTime) { // Connected
  currentCall.bye()
} else if (currentCall.reject) { // Incoming
  currentCall.reject()
} else if (currentCall.cancel) { // Outbound
  currentCall.cancel()
}
```

## 对方拨打

### 接听来电

调用来电钩子所返回invitation中的accept方法，传入通话配置，进行接听电话

```js
invitation.accept(callConfig)
```

### 拒接来电

调用来电钩子所返回invitation中的reject方法，拒绝接听电话

```js
invitation.reject()
```

### 通话回调事件

```js
// 我方拒接电话
invitation.on("rejected", ()=> {

})

// 本次通话结束
invitation.on("bye", ()=> {

})

// 我方接听电话
invitation.on("accepted", ()=> {

})

// 对方取消通话
invitation.on("cancel", ()=> {

})
```

### 挂断
```js
if (!invitation) {
  return
} else if (invitation.startTime) { // Connected
  invitation.bye()
} else if (invitation.reject) { // Incoming
  invitation.reject()
} else if (invitation.cancel) { // Outbound
  invitation.cancel()
}
```

## 注销UA

```js
if (myUA instanceof Object) {
    myUA.unregister()
    myUA.stop({
      register: true
    })
}
```

最后修改：2022 年 12 月 07 日