ringcentral-softphone-js

KO | EN

gitlite — search

#react #llm #go #golang #rust #deep-learning #nodejs #windows #cli #vue #awesome-list #security #ios #openai

ringcentral-softphone-js

(★ 23)

RingCentral Softphone SDK for JavaScript

ringcentral-softphone-js Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Project moved

Please check [RingCentral Softphone SDK for TypeScript](https://github.com/ringcentral/ringcentral-softphone-ts) instead.

## This repo has been abandoned

## Please use [RingCentral Softphone SDK for TypeScript](https://github.com/ringcentral/ringcentral-softphone-ts) instead

## What are the differences between ringcentral-web-phone and this project?

[ringcentral-web-phone](https://github.com/ringcentral/ringcentral-web-phone) is designed for client side and only works with browsers.

This project was originally designed for server and desktop. It doesn't require a browser to run. It could run in browser too.

## Supported features:

- Answer inbound call
- Make outbound call
- Speak and listen, two way communication
- Call control features
    - Redirect inbound call to voicemail
    - Ignore inbound call

## Demos

- [browser demo](./demos/browser)
- node.js
    - [answer inbound call](./demos/node/answer-and-talk.js)
    - [make outbound call](./demos/node/outbound-call.js)
    - [redirect inbound call to voicemail](./demos/node/to-voicemail.js)
    - [ignore inbound call](./demos/node/ignore.js)
- [call supervise](https://github.com/tylerlong/ringcentral-call-supervise-demo)
    - supervise an existing phone call and get real time audio stream

## Install

```
yarn add ringcentral-softphone @rc-ex/core
```

For node.js you also need to:

```
yarn add ws wrtc
```

## Usage

- for node.js, check [here](./demos/node)
- for browser, check [here](./demos/browser)

## Get realtime inbound audio

```js
import { nonstandard } from 'wrtc'

softphone.once('track', e => {
  const audioSink = new nonstandard.RTCAudioSink(e.track)
  audioSink.ondata = data => {
    // here you have the `data`
  }
  softphone.once('BYE', () => {
    audioSink.stop()
  })
})
```

The data you got via `audioSink.ondata` is of the following structure:

```js
{
  samples: Int16Array [ ... ],
  bitsPerSample: 16,
  sampleRate: 48000,
  channelCount: 1,
  numberOfFrames: 480,
  type: 'data'
}
```

Please note that, you may get different numbers, for example, `sampleRate` you get might be 16000 instead of 48000.

## Official demos

### Setup

```
yarn install
cp .env.sample .env
```

Edit `.env` file to specify credentials.

- `CALLEE_FOR_TESTING` is a phone number to receive testing phone calls. You don't need to specify it if you do not make outbound calls.
- If you have `WEB_SOCKET_DEBUGGING=true`, then all WebSocket traffic will be printed to console.

### Run

- for node.js `yarn server`
- for browser `yarn browser`

### Test

Make a phone call to the phone number you configured in `.env` file. The demo app will answer the call and you can speak and listen.

## Interesting Use cases

### Call supervision

Let's say there is a phone call ongoing between a customer and the call agent.
You can use this library to supervise this phone call to get live audio stream.
You can analyze the audio stream using some AI algorithm and provide tips to the call agent in real time.

### Live transcription

Use this library to supervise an existing phone call to get live audio stream.
Translate the audio stream into text by invoking some speech-to-text service.
Show the text to the caller and/or callee so they can see live transcription.

### Play recorded audio

You can create a program to make a phone call or answer a phone call and play recorded audio.
This is good for announcement purpose. This is also good for quick voicemail drop.
Or you can use text-to-speech service to read text to the callee.

## Todo

- How to create a publish message
- How to forward a call

ringcentral-softphone-js

ringcentral-softphone-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ringcentral-softphone-js

ringcentral-softphone-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README