Getting started guide

This document describes the tasks required to set up a Dolby Conference Phone app software development environment.

Set up the development environment

Dolby supplies an Integrated Development Environment (IDE) for the Dolby Conference Phone app development. This IDE is a virtual appliance and can be installed in your preferred virtualization environment. The development environment set-up process consists of these steps:

  • Download the virtual appliance IDE package file.
  • Install the package in your virtualization environment.
  • Create a project for the new app.
  • Deploy the project in the app deployment server that is included in the IDE.
  • Configure the Dolby Conference Phone to download your app from the app deployment server.

Download and install the IDE

Supported virtualization environments for the virtual appliance file are as follows.

  • VMware® Player 5.0 or later
  • VMware vSphere® 5.0 or later
  • Oracle VirtualBox 5.0.10 or later

Note: This topic assumes that you know how to use the third-party virtualization environment such as those listed above. Specific directions on how to use these applications are beyond the scope of this document.

  • Import a recent version of the Dolby Conference Phone app IDE (dcp-sdk-3.0.0.x.ova) with your virtualization environment.
  • Start the Dolby Conference Phone SDK virtual appliance.
  • From the GUI, log in to the SDK IDE with the default user name (root) and password (dolby).
  • Open a terminal window and then use the ifconfig command to obtain the IP address of the SDK IDE virtual appliance. For example:
    [root@dcc ~]# ifconfig
    eth0 Link encap:Ethernet HWaddr 08:00:27:02:85
    inet addr: 10.112.100.167 Bcast 10.112.101.255 Mask: 255.255.254.0
  • In this example, the IDE virtual appliance IP address is 10.112.100.167. This IP address will be used later on to set the app deployment server URL.

Update the IDE

Dolby issues regular updates to the SDK with a RPM package so you do not need to rebuild the VM environment from scratch. Follow the instructions below to update the VM environment.

  • Download the latest SDK RPM (e.g. dcp-sdk-1541-1.x86_64.rpm) from Dolby.
  • Enter the following command to update the SDK
    rpm –Uvh dcp-sdk-1541-1.x86_64.rpm

Create the app

  • Create a working directory named apps under the folder /usr/share/nginx/html/apps
  • Double click the Qt Creator icon on the desktop.
  • Click on "New Project" and select "Application" and then "Dolby Conference Phone App".

  • Name the project hello-world and create the project under the /usr/share/nginx/html/apps folder.
  • Add a file called Servermain.qml to the project and make sure it's under the /usr/share/nginx/html/apps/hello-world folder.
  • Copy and paste the code example below into the Servermain.qml file and save it.
  • Obtain a code signing certificate from Dolby
  • Modify .app.cfg. This is a hidden file that is automatically created when a new QT project is set up. Use the ls -al command to view it in the /usr/share/nginx/html/apps/hello-world folder. Edit the file parameters to match your development project. Note that the "name" parameter must match the "Common Name" value that was used to create the signed certificate (refer to the table in this section). The following shows the contents of a newly-created .app.cfg file.
    {
        "version": "0.0.1",
        "name": "My DCP App",
        "developer": "Developer",
        "contact": "developer@example.org"
    }
  • Sign the app to update the .app.cfg file and create a signature file.

Code example

import QtQuick 1.1
import com.dolby.dcp.components 1.0
import com.dolby.dcp.engine 1.0

UIApplication {
    // Run this app immediately once it is loaded.
    autoLaunchAfterLoad: true

    Component
    {
        // Identifier for helloworld page.
        id: helloWorld
        // Create a UI page
        UIPage
        {
            // Do not show navigation bar for this page
            navigationBarVisible: false

            // Display "Hello, world!" using the theme's active text color.
            Text
            {
                text: "Hello, world!"
                font.pointSize: 36
                color: Theme.activeTextColor
            }
        }
    }

    // Create connection with "app" object of engine
    Connections
    {
        target: app
        // launchApplication() signal is emitted when application needs to be launched
        // Here we define slot for that signal.
        onLaunchApplication:{
            // log message to syslog
            Logger.syslog(LogLevel.DEBUG, "Hello world app launched!");
            // load main view with helloWorld page on launch
            app.loadMainViewFromComponent(helloWorld);
        }
    }
}

Load and run the app

Get the IP address of the phone.

  • Click the Settings icon on the home screen of the phone.
  • Click the More button (...) on the left hand side navigation bar.
  • Click About.
  • Click General.
  • Swipe up the screen and find the IP address.

Configure your Dolby Conference Phone with the web UI as follows.

  • Enter the phone's IP address into your web browser's address bar.
  • Log in with the default user name (admin) and password (1739).

Note: The Dolby Conference Phone must be running 3.0.0.x software or newer

Note: Use the virtual appliance IDE IP address from the earlier ifconfig step to set the server address field. In this example, the app URL becomes /http://10.112.100.167/apps/hello-world/

ParameterValueWeb UI location
Features.OperationModeDual Mode or Conferencing Only ModeSettings > Features > Operation Mode
Dvms.Server.Addresshttp://10.112.100.167/apps/hello-world/Settings > Dolby Voice Conferencing Service > Server
Dvms.Service.ProviderCustomSettings > Dolby Voice Conferencing Service > Service > Service Provider
Dvms.Service.TypeAppSettings > Dolby Voice Conferencing Service > Service > Application Type

The Dolby Conference Phone may reboot and load the new configuration. The hello-world app is set to automatically launch when the Dolby Conference Phone reboots. Once it's launched, you will see following UI on the Dolby Conference Phone screen.

"Hello World"

Make some changes and reload the app

After modifying the app, you will need to sign the app again. Alternatively, you can whitelist the Dolby Conference Phone.

Press and hold the mute button on the Dolby Conference Phone for 5 seconds. This will reload the hello-world app from the app deployment server.