Dejero LIVE+ Platform
LIVE+ Mobile App User Manual
© 2013 by Dejero Labs Inc. All rights reserved.
Patents pending.
Document number: [20130823]
Dejero
www.dejero.com
General Inquiries:
Canada & U.S.: 1.866.808.3665
International: +01 519.772.4824
Service and Support:
Canada & U.S.: 1.866.808.3665
International: +01 519.772.4824
The Dejero LIVE+ Platform 3
The Dejero LIVE+ Platform Rely on Dejero’s robust and field-proven television equipment for critical live broadcasting. The Dejero
LIVE+ Platform is comprised of the following components:
The Dejero LIVE+ 20/20 Transmitter
This ruggedized professional-grade wireless broadcasting solution allows you to respond on scene, set up in
seconds, and go live before your competition. With a single push of a button, transmit broadcast quality HD or
SD live video over bonded cellular and wireless networks.
The Dejero LIVE+ VSET
A 1-U vehicle-mount transmitter designed for use in satellite and microwave trucks. A breakthrough in
traditional electronic newsgathering, the LIVE+ VSET transforms your station’s OB vehicles into next generation
super-vehicles for HD or SD video over cellular, microwave, and satellite.
The Dejero LIVE+ NewsBook
The LIVE+ NewsBook is a wireless broadcasting solution that runs on laptop (or desktop) computers to transmit
live video or edited packages over multiple wireless or wired networks. The ability to import and export clips
means you can edit your story in the field.
The Dejero LIVE+ Mobile App
This professional broadcasting APP allows anyone in your organization to become a field reporter, carrying
nothing but their cellphone. An industry first, this APP has the capabilities of bonding multiple wireless signals
to provide high quality live video from on the street.
The Dejero LIVE+ Broadcast Server
Connect the server directly into your existing equipment for real-time genlocked HD or SDI video from multiple
LIVE+ Products.
The Dejero LIVE+ Cloud Transcoder
Capture and stream your live event easier than ever using Dejero LIVE+ Cloud Transcoder. Drive traffic to your
website and expand the reach of your live events to mobile devices. Broadcast government or organizational
announcements, corporate meetings, breaking story coverage or any other special event you want to stream
from your website.
The Dejero LIVE+ Portal
A powerful online interface that centrally manages, tracks, and controls all of your Dejero newsgathering tools.
At the click of a mouse, change settings or control where you send your video.
Warranty and Liability The information in this manual is
Warranty and Liability 4
subject to change without notice, and does not represent a commitment on the part of Dejero Labs
Inc.
Due to the nature of wireless communication, transmission and reception of data can never be
guaranteed. While Dejero strives to provide high–quality video transmission without significant delays,
environmental and cellular network conditions beyond Dejero’s control may result in data delay,
corruption or loss.
Dejero accepts no responsibility for and is not liable for any loss or damage, including but not limited to
revenue or personal injury, resulting from delays in, errors in, or failure to transmit or receive data
using the Dejero LIVE+ Platform.
Download from iTunes App Store 5
5
Download from iTunes App Store
The Dejero LIVE+ Mobile App is available for download from the iTunes App Store.
Launch the iTunes App Store and search for ‘Dejero’. Once the app is downloaded and
installed on the iPhone 4, iPhone 4S iPhone 5, iPad 2 or the new iPad go to the settings
app to make any necessary adjustments that are necessary.
Note: iPhone 4 is capable of Store and Forward Only – Live transmission from an
iPhone 4 is not possible.
App Settings
The Dejero LIVE+ Mobile App is designed to be simple and easy to use, however there
are a few settings that may need to be adjusted. These settings configure the video
output to match the broadcast environment and any station policies. Launch the
settings app and scroll down to the Dejero LIVE+ app to setup your app.
First set the camera output to either NTSC (30 fps) or PAL (25 fps) depending on your
broadcast region. As well set the format to either Wide Screen 16:9 or 4:3 aspect ratios.
There are three settings available for Live Streaming: if you would like to limit the
bandwidth of the stream to save on Cell Data usage set the Max BPS otherwise set to
Auto, which will use the all the available bandwidth for best picture quality. This setting
can also be used to limit the data rate in congested area with spotty Internet reception
– more on this in the troubleshooting section.
IFB Output can be turned off to save bandwidth when IFB output from the headphone
jack is not used.
In cases where the station sets the latency in the Portal for the Server, you need to turn
on the Preset Latency setting. This will disable the user setting of latency (1, 3, or 8
seconds) and only use the station Preset for the Server the iPhone is transmitting to.
Summary of updates since 2.0 6
6
Turn off Use Cell Radio to prevent the Dejero
LIVE+ app from using the cell radio. When this
setting is on the app will bond both the Wi-Fi
and cell connections.
By turning on the Autosave setting the Dejero
App will automatically save a copy of the video
in the camera roll on the iPhone after it has
been sent to a Dejero LIVE+ Broadcast Server
(Store and Forward mode).
Summary of updates since 2.0
- IFB Support added
- Improved Encoding algorithm
- Preset Latency added
- Confirm delete message when deleting a
clip that has been recorded
- Audio meter for microphone input
- Display server ingest name in Start
button when on air
- Improved error messages and status
- Native iPhone 5 and iPad resolutions
First time Launch 7
7
First time Launch
When the app is first launched it will prompt you for permission to use your current
location. Press OK to grant permission. This will send location information back to the
station. As well, the app requires access to your current location to use the Import
feature.
Next enter your assigned username and password to log into Dejero Dispatcher.
This username is not the same login used to access to Dejero LIVE+ Portal. The
dispatcher determines which station/server/ingest your iPhone will transmit to. This
assignment is done by the station operator in the Dejero LIVE+ Portal.
The username and password will only need to be typed in once, the Dejero LIVE+ app
will remember your username and password and automatically log you in when the app
is launched again.
Camcorder View Screen 8
8
Camcorder View Screen
The main screen or view on the Dejero LIVE+ mobile app is designed to look and feel like
a traditional camcorder view screen. At all times, before and during live transmission or
recording you can view exactly what your video will look like. This allows you to
properly frame the scene before going on air or recording.
All of the functionality of the application can be accessed from the 6 buttons on the
screen. The top three buttons will start/stop and control the camera on the device. The
bottom right button sets the mode of operation. There are three modes of operation –
live transmission, record a video or import a video from the devices camera roll.
The bottom left bottom allows you to adjust the settings for either live mode or
recording mode. The context of this button will change according to which mode (either
live or record) the app is performing.
Note: the flash light on/off button will not be present when a camera (the front camera
on an iPhone) is selected that does not have a flash, or on the iPad which does not have
a flash light for either camera.
At the very bottom left corner of the screen is the ‘reveal’ clip manager button. The clip
manager allows you to manage and view the status of any pre-recorded video that is
being sent to the server. The clip manager screen will slide up and cover the camcorder
viewfinder screen.
Live Transmission 9
9
At the top of the screen is the device’s status bar. This status bar will indicate the signal
strength of Wi-Fi/cell connections, the current time, and the battery charge level. This
information is available at all times.
Live Transmission
Note: The iPhone 4 device is not capable of live video transmission. Live transmission
requires an iPhone 4S, iPad 2 or the new iPad.
The Dejero LIVE+ Mobile App is capable of transmitting live video/audio anywhere cell
connectivity or Internet is available via Wi-Fi. As well, the app can bond, or use both Wi-
Fi and cell radios simultaneously, creating a more reliable video transport.
Select Live mode with the Operations mode button, the settings button on the bottom
left allows you to select the delay or latency of the video transmission. A short delay of
1.5 seconds allows operation where the iPhone operator can interact with the studio.
However, a short delay also decreases the amount of time that the app can do any error
correction in case of cell network congestion – which can result in loss or stuttering of
the video.
As a general rule of thumb, a delay of 3.0 seconds provides a compromise of short delay
for interaction with the studio and enough time to correct any problems with network
Live Transmission 10
10
congestion. For maximum reliability, where interaction is not required, set the delay to
8.0 seconds.
When the app is set to use the Preset Latency, this control is grayed out and displays
“Preset”
Going on Air 11
11
Going on Air
Press the Start button to ‘Go On Air’. The app will enter a ‘Starting’ phase. During this
phase the app will retrieve the current assignment (which Server and ingest to transmit
to) and negotiate a connection with the Server. During this starting phase there are
several possible errors that may occur, preventing going on air.
In case of transmission error an alert box will open indicating the cause of the error.
The condition must be corrected in order to go on air. Some of the error conditions are:
Device has not been assigned a server output. An iPhone must be assigned a Server
output to transmit the live video to. This is done by the station manager with the
Dejero LIVE+ Portal.
Server in use. The iPhone is attempting to transmit video to a Server that is currently in
use already. The iPhone needs to be assigned to another Server or wait until the Server
currently assigned in not in use.
No Internet Connectivity. The iPhone is not connected to the Internet. You can double
check the connectivity by attempting to surf the Internet on the Safari web browser.
Bandwidth Testing Phase 12
12
Unsupported Video Format. The server reported that it did not recognize the video
format that the iPhone was trying to transmit. The cause of this error is either an
incorrect NTSC/PAL setting or the server is running a version of the software that does
not recognize the video formats that the iPhone produces. The current minimum
version that should be running on the Server is 2.6.1.6701.
Server not responding. The iPhone attempted to connect to the Server but got no
response. First, test that the Server is online and functioning; this can be done in the
portal with the ‘Ping’ test. If the Server is online and functioning then follow the
diagnostics guide for setting Server IP addresses.
All ingests are in use. The iPhone has been assigned to a pool of Server ingests and all
of the ingests are currently in use by other iPhones/transmitters. The user will need to
wait until an ingest is free to be able to transmit.
Bandwidth Testing Phase
If the app passes the initial connectivity tests, next it will enter the bandwidth-testing
phase. During this phase the app will probe the characteristics of the Wi-Fi and/or cell
connections. Both the available and bandwidth and latency of the signal are tested.
Broadcasting Live 13
13
During this Testing phase you’ll see a graphical overlay showing the bandwidth (in
translucent white) and latency as a blue line. If one of the connections is not available
you’ll see the bandwidth as 0 kbps.
Broadcasting Live
While broadcasting live, the ‘Start’ button will change to ‘On Air’ and the colour will
change to green. The front/back camera toggle button can be used to switch from the
back camera to the front and vice versa. As well, if available, the flash can be turned on
and off.
In the left corner of the video display is an IFB badge. This badge will be displayed when
IFB is turned on and available from the server. The right corner of the video display
shows a VU meter for the microphone input.
Along the bottom of the screen the app will display some statistics showing how well
the transmission is performing. The first number on the left is the video encoder rate in
bits per second, the higher the number, the better the quality. Generally the ranges of
quality can be mapped out as:
0-200 kbps – very poor quality or possible no video signal
Errors While Broadcasting 14
14
200-750kbps – low quality, but suitable for ‘head shots’ with little motion
750kbps – 1500kbps – medium quality, suitable for motion
1500kbps – 2200kbps – high quality video
2000kbps and above – excellent quality video
The number next to the video encoder rate is the current delay or latency of the signal.
This is the setting that you applied before going on air and doesn’t change.
Beside the latency, is a bar graph showing the relative strengths of the cell and Wi-Fi
connection when using bonded transmission (this graph does not appear when using
only a single connection). A long black bar indicates that the connection is good and has
enough bandwidth to produce a high quality video signal. A shorter bar means the
bandwidth on that connection is less than high quality. Since the app will bond both the
cell and Wi-Fi connections, two shorter bars can produce a high quality video signal.
In the bottom right corner is a time clock indicating how long the app has been
broadcasting live video.
Errors While Broadcasting
If there are any errors while broadcasting live a yellow status band will appear on the
bottom of the screen indicating the type of error that occurred.
Going Off the Air 15
15
When the error clears the yellow band will disappear. Some of the error messages that
can occur during live broadcast are:
Not enough bandwidth to transmit. No video or audio is being broadcast because the
connectivity connections are too poor. Finding a different location with better cell
coverage is a suitable resolution.
No Internet connectivity. The app has lost all Internet connectivity. Relocating to a
different location and restarting the broadcast is a suitable resolution.
Latency of signal too high. There is enough bandwidth available, however the latency
or delay of the broadcast is too high to transmit in the current delay setting. This error
will occur if the app is set to a low delay (1.5 seconds or 3.0 seconds) and the network
conditions are too poor to transmit video at that setting. Restart the transmission at a
longer delay is a suitable resolution.
Going Off the Air
Press the green ‘On Air’ button (previously labeled ‘Start’) to stop transmitting live and
go off the air. The app will stop transmitting and notify the Server and the Dejero LIVE+
Portal that it is going off the air. This phase will take about 2 seconds and the button
Store and Forward 16
16
will be labeled ‘Stopping…’ during this phase. When the stopping phase is completed
the app will reset back to the main camcorder screen.
Store and Forward
Besides transmitting live video, the Dejero LIVE+ Mobile App features the ability to
record video and send this recorded video to the Dejero LIVE+ Broadcast Server at a
later time. Using this technique a high quality video can be recorded when network
conditions are too poor to transmit live and then uploaded later.
As well a video can be imported from the device’s camera roll and uploaded to the
Dejero LIVE+ Broadcast Server. The video could be recorded or edited with another app
using this technique.
To change modes from Live transmission to Record or Import press the Operation mode
button in the bottom right corner of the screen.
Recording a video
Review, Send, Save or Delete 17
17
When the app is in record mode, the lower left settings button allow you to set the
encoding rate of the recording video – 2.0Mbps (low), 4.0Mbps(medium), 6.0Mbps
(high). The higher the encoding rate, the better quality recording and the longer it will
take to upload the file to the Dejero LIVE+ Broadcast Server.
Press the Start button to begin recording video. While the app is recording you can use
the camera control buttons to switch the front and rear cameras, and turn the torch
light on/off.
While the app is recording video the ‘Start’ button label will change to ‘Recording’ and
the colour of the button will turn green. In the bottom right corner a timer will start
indicating the recording duration. Press the ‘Start/Recording’ button again to stop
recording.
Review, Send, Save or Delete
Immediately after recording the video the app enters a phase where you can review the
video. On the bottom of the screen are playback controls that allow you to pause,
rewind, scrub the video. The audio will play out the device’s speaker.
Sending video 18
18
Along the top of the screen are three options. You can send the video to the Dejero
LIVE+ Broadcast Server, save the video the camera roll or delete the video. Choosing
save to camera roll allows you to export the video so it can be edited by an external app
(such as the Avid Video Editor).
Sending video
Pressing the send button on the screen, will start the send operation. A thumbnail of
the video (for easy identification in the Store & Forward portal) is generated, as well as
other meta data. The clip manager screen will slide up and the sending of the clip will
start.
If the cell radio is enabled in the Settings panel, the app will bond both the Wi-Fi and the
Cell connections and send the video as quick as possible. Sending will continue in the
background, you can record another video or even go live (the send will be temporarily
paused during live transmission).
Clip Manager
The clip manager screen allows you to monitor the sending of clips, pause the sending of
clips and deleting of clips being sent.
Clip Manager 19
19
On the left side of the screen are some status items – the server the files are being sent
to, the upload speed in kilobits per second and the estimated time and total bytes
remaining for clips being uploaded.
On the right side of the screen is a list of clips being sent. A thumbnail representation of
the video identifies the video, a progress bar shows how much of the video clip has
been sent and each clip has a status button that indicates the status of the clip being
transferred. There are four possible status states:
Sending. The clip is currently being sent. Only one clip at a time will be in the sending
state.
Queued. The clip is queued to be sent after the clips above have been sent.
Complete. The clip transfer has been completed and is available on the Server for
playback. Only complete clips can be played, partially transferred clips are not playable
on the Server.
Paused. Clip transfer has been paused by the user. At any time the clip is in the
Sending or Queued state you can press the status button to pause the clip. Pausing a
clip transfer is a means to prioritize a particular clip for transfer, by pausing the clips that
Importing clips 20
20
are ahead (above in the list) in the Queue. Pressing the status button while a clip is
paused will start the transfer for that clip again.
The screen shot above shows the top clip ‘Paused’. The clip below immediately goes
from Queued to Sending, thus transferring the second clip before the first.
Deleting clips
To delete the clip from the clip manager swipe your finger over the clip from left to
right. The status button will change to a Delete button. Tap the Delete button to delete
the clip from the clip manager. Or tap anywhere else to cancel the delete operation.
Dismissing the Clip Manager
Press the dismiss button in the top right corner of the screen to close the clip manager.
The app will return the main screen where you can record another clip or go live on air.
This can be done while clips are being sent to the Server.
Importing clips
Dejero LIVE+ requires Location Services enabled to import21
21
Clips can be imported from the camera roll and sent to the Server. Press the Operation
mode from the main screen and select Import. A clip selection screen will slide up
allowing you to select 1 or more clips from the camera roll. Note: only video clips will be
shown; pictures cannot be selected and sent to the Dejero server.
Tap the thumbnail representation of the clip to select it. A green checkmark will appear
in the lower right corner indicating the clip is selected. Tapping a selected clip will
deselect the clip. Press the Done button in the top right corner when you have finished
selecting the clips to import. Note: if no clips are selected, pressing Done will cancel the
Import Operation.
Review, Send or Cancel
After pressing the Done button the app will allow you to review the clips you have
selected. Playback controls to pause, rewind and scrub the clips. If more than one clip
was selected, the clips will be played one after another. Press the send button to start
sending the clips, or press the Cancel button to cancel and return to the main screen of
the app.
Dejero LIVE+ requires Location Services enabled to import
Dejero LIVE+ requires Location Services enabled to import22
22
If the app does not have Location Services enabled (access to the GPS) and access to the
Photo Library then the Import operation will not function. An error message will appear
when the Import button is pressed – “Dejero LIVE+ requires Location Services enabled
to import video”
For iOS 5.1
To enable the import feature, Location services must be enabled for the Dejero LIVE+
Mobile App. Go to the Setting App, select Location Services (in the top group), then
scroll down to Dejero LIVE+ and set the toggle switch to On.
For iOS 6.0 or later
To enable the import feature, go to the Settings app, select Privacy. Make sure Location
Services is On and the Dejero App is also On.
Then select Privacy->Photos and make sure Dejero LIVE+ is also on.
Left or Right handed operation 23
23
Other Features
The following are a list of features that are available in all modes of operation.
Left or Right handed operation
The front and rear cameras on the iDevice are located on one side of the device. Left
handed or right handed users may find it more convenient to hold the device such that
their hand does not block the cameras. The user interface will automatically rotate for
left or right-handed operation.
Tap to focus
Tapping the screen can focus the rear-facing camera. The front facing camera is a fixed
focus camera and is always in focus. As well, when the camera is switch from the front
facing camera to the rear-facing camera the camera is automatically focused.
Auto start of sending clips
When the app is first launched it will scan for any clips in the clip manager that have not
been sent to the server. If unsent clips are found, it will automatically start sending
clips. Pause any clips to disable that clip from automatically being sent.
As well, if clips are being sent and a live transmission is started, the clip sending is
temporarily suspended. After going off air, the clip sending is automatically started
again.
Other Audio Topics 24
24
IFB Audio and other Audio topics
In order to access IFB on the iPhone, the server must be configured with IFB – the
process is exactly the same as configuring the server for IFB to a 20/20 Transmitter.
IFB will only play out the 3.5mm headphone jack on the iPhone. You can use either the
headphone/microphone ear buds that come with the iPhone or use a splitter that allows
a headphone/earphone and an external microphone to be connected to the 3.5mm
jack.
IFB will not play out the speaker of the iPhone.
IFB Output starts immediately after the Start button is pressed and the iPhone has
connected to the server. It will play output during the Bandwidth Testing phase and
while on air. IFB is continuous even during low latency error messages while
broadcasting.
Other Audio Topics
The iPhone captures audio at 24K samples per second and encodes the audio at 56Kbps
mp3 audio. Best performance in audio can be achieved with a professional external
microphone connected to the 3.5mm audio jack on the iPhone. Audio is more suited to
voice rather than musical audio.
Incoming IFB audio is encoded in low latency speex codec with is tuned for voice type
audio. Musical IFB audio is not recommended.
VU Meter feedback
New with version 2.3 is the VU meter on the camcorder display of the app. This VU
meter shows a pseudo accurate level of microphone input. More bars are better.
VU Meter feedback 25
25
Troubleshooting guide
iPhone app gets stuck in the Starting… phase
During the starting phase of live transmission the iPhone will get the assignment from
the portal and do a time synchronization with the Server. If the latency of the
transmission is too great or varies greatly it may take a long time to complete this
phase. Possibly remedies are:
- set the latency to 8.0s or use a preset that is longer than 8.0s and retry
transmission
- Try transmitting at a alternate location where cell connectivity is better
- Bond Wi-Fi + cell (possibly using a Mi-Fi hot spot with another carrier)
- Make sure your iPhone is up to date with the latest version
- Use Store and Forward and record a clip to be transferred at another time when
connectivity is better
iPhone app gets stuck in the Testing… phase
During the testing phase of live transmission the iPhone is probe and negotiate a
transmission rate with the Server. If the latency of the signal is too great or varies too
much then a longer than expected testing… phase will occur. Possible remedies are:
- set the latency to a higher setting to compensate for the varying conditions
- bond Wi-Fi + cell
- Set the maximum bps from Auto to a lower setting. This will improve conditions
where a Wi-Fi/cell tower is buffering packets but unable to pass these packets on
to the internet in a timely manner.
- Restart transmission in an alternate location where connectivity is better
All other trouble shooting
Perhaps the most important thing to remember when troubleshooting the Mobile App,
is that all the same troubleshooting steps that apply to the 20/20 Transmitter also apply
to the app. The iPhone app runs the same CORE code as the 20/20 Transmitter and
requires the same setup and conditions as the 20/20. Treat the iPhone app as a 20/20
when troubleshooting any connectivity or transmission problems.