Getting Started: Building for BlackBerry 10 (BB10)

1. Requirements
2. Building PJSIP
3. Simulator
4. Notes
   1. GSM Call Interruption Problem

BlackBerry 10 (BB10) target is available in the Subversion trunk.

When it ships, BB10 is expected to have native echo cancellation.

For the latest guide see this ​blog post.

Requirements

• You'll need BlackBerry 10 Native SDK. After you download the SDK, set the environment variables by running bbndk-env script provided in the SDK:

  $ source bbndk_dir/bbndk-env.sh
  

• ​BB10 PJSIP Demo
  • In particular read through ​README

Building PJSIP

Get the source code, if you haven't already.

Just run:

$ cd /path/to/your/pjsip/dir
$ ./configure-bb10
$ make dep && make clean && make

Notes:

• the ./configure-bb10 is a wrapper that calls the standard ./configure script with settings suitable for BB10 target.
• you may pass standard ./configure options to this script too.
• for more info, run ./configure-bb10 --help
• other customizations are similar to what is explained in Building with GNU page.

Simulator

Install and configure the BB10 simulator, you will need to install a virtual machine player in order to use the simulator. To build for BB10 simulator, just run:

$ ./configure-bb10 --simulator
$ make dep && make clean && make

Notes

GSM Call Interruption Problem

If a VoIP call is in progress when an incoming GSM call arrives, and if the user accepts the GSM call, the audio routing of the phone is flawed producing the following result: The VoIP call goes to speaker and the GSM call does not “grab” the audio channels so you get a “null” GSM call and the VoIP call carries on with speaker.

To prevent this from happening, application must implement GSM call detection using BB10 native API, and when it detects a GSM call, it should close PJSIP sound device by using either pjsua_set_null_snd_dev() or pjsua_set_no_snd_dev() and put the VoIP call on hold before accepting the GSM call.

Thank you Bob Cripps of Truphone for the note.