https://github.com/ringcentral/ringcentral-pjsip

Use PJSIP to create RingCentral device simulators
https://github.com/ringcentral/ringcentral-pjsip

Last synced: 8 months ago
JSON representation

Use PJSIP to create RingCentral device simulators

README

# ringcentral-pjsip

Use [PJSIP](https://www.pjsip.org/) to create RingCentral device simulators.

Technical Reference: [slides](https://docs.google.com/presentation/d/15KvnbZVB_adSN6xjwlRHh-dsc3HWeVrAkxvBRSLVGPc/edit?usp=sharing).

## Setup

```
docker build -t ringcentral-pjsip .
cp credentials.sample.hpp credentials.hpp
```

Edit `credentials.hpp` and specify credentials.

## Run

```
docker run -it --rm -v $(pwd):/ringcentral-pjsip ringcentral-pjsip ./run.sh .cpp
```

For example:

```
docker run -it --rm -v $(pwd):/ringcentral-pjsip ringcentral-pjsip ./run.sh demos/call-and-play-wav-file.cpp
```

## Test

Call the phone number associated with your RingCentral device.

## Todo

- How to deploy to AWS?
- Add demo about microphone and speaker
- high concurrence
- one application to handle handreds of calls

## Miscellaneos

### How to gererate wav file for testing

```
say -o temp.wav --data-format=LEI16@48000 "Hello world"
```

Command above convert text "Hello world" to `temp.wav` file.

**BUT** this file doesn't have proper headers.

In order to fix it, we need ffmpeg:

```
ffmpeg -i temp.wav hello.wav
```

## Dev notes

How to run a docker bash:

```
docker run --rm -it ringcentral-pjsip /bin/bash
```

- Ref: https://docs.pjsip.org/en/2.10/pjsua2/account.html

## Emergency Address

If you change your device's emergency address on service.ringcentral.com, sometimes the emergency address will be pending or failure to change.

If it happens, your cannot make any outbound calls. Server side will reply with `SIP/2.0 486 Busy Here` if you try to make outbound calls.