The "Hello, World!" Example

Table of Contents

  1. Introduction
  2. Create a Hello World Dolby Conference Phone app
  3. Create a Hello World web app for the Dolby Voice Hub
  4. Load and run the app
  5. Results

1. Introduction

This document demonstrates how to create, load, and run a simple "Hello, world!" application on a Dolby Voice Room system. Because this system consists of a Dolby Voice Hub that is paired with a Dolby Conference Phone, two apps are required: an HTML/JavaScript app for the Dolby Voice Hub and a QML app for the Dolby Conference Phone.

The basic steps are:

  • Write a QML app and sign it.
  • Write a web app in HTML/JavaScript (no signing needed).
  • Copy the QML app to a web server.
  • Copy the web app to a web server.
  • Set two Dolby Voice Hub parameters to point to web server.
  • The apps should automatically load and run on both the Dolby Voice Hub and Dolby Conference Phone.

Details are provided below.

2. Create a Hello World Dolby Conference Phone app

See the Getting started guide to create the QML Hello World Dolby Conference Phone app. Note that the steps to load a QML app onto the Dolby Conference Phone are different when the phone is paired with a Dolby Voice Hub, so do not follow the steps in the Load and run the app section. The app files along with the signature files still need to be copied to a web server.

Note: The Dolby Conference Phone web UI is not used for setting the app configuration parameters. This should be done using the Dolby Voice Hub web UI; refer to steps in section 4.

3. Create a Hello World web app for the Dolby Voice Hub

The Dolby Voice Hub app used in this test is a simple HTML file named hello-world-vh.html:

<!DOCTYPE html>
<html>
<head>
   <style>
      body {background-color: black;}
      h1  {color: aqua;}
   </style>
</head>

<body>
   <h1>Hello, world!</h1>
</body>

</html>

You can host the Dolby Voice Hub app on any web server. If you use nginx in the Dolby IDE, create a folder that nginx will use to serve the Dolby Voice Hub application, e.g.,

# mkdir /usr/share/nginx/html/apps/hello-world-vh

Copy the hello-world-vh.html file to this folder.

Note that unlike the QML app, the Dolby Voice Hub app does not need to be signed.

4. Load and run the app

Get the web server's address or URL that will be used for downloading the apps. If using nginx in the Dolby IDE, issue an ifconfig command in a shell window running on the IDE. Use the IP address associated with the eth0 interface. In this example, the address is 10.112.102.205.

Log in to the Dolby Voice Hub web UI to configure the Dolby Voice Hub to download and run the Hello World apps:

Parameter Value Web UI Location
Dvms.HubApp.Url http://10.112.102.205/apps/hello-world-vh/hello-world-vh.html Settings > Dolby Voice Conferencing Service > Hub Application
Phone.App.Url http://10.112.102.205/apps/hello-world/ Dolby Conference Phone > Application > Application URL

In this example, two separate nginx folders were used; the apps could have been copied to just one folder.

5. Results

The Dolby Conference Phone should display "Hello, world!" and the monitor connected to the Dolby Voice Hub should also display "Hello, world!" as shown below.

Dolby Conference Phone:

alt text

Dolby Voice Hub:

alt text