Link Search Menu Expand Document

Livestream widget setup

Jan 1 2022 at 12:00 AM

  1. Overview of Commander™ Functions
  2. Introduction
  3. Required software and licenses
    1. Setup instructions for Mersoft Move and Mersoft Stream
  4. Commander™ setup
    1. Tenant environment settings
    2. Livestream video widget setup
      1. Entity setup
      2. Widget subscription

Overview of Commander™ Functions

Introduction

The purpose of this document is to help the Commander™ user setup Livestream video and the prerequisite software.

Required software and licenses

The Livestream widget needs Mersoft Move and Mersoft Stream servers to be setup and configured on the tenant. For more information about the Mersoft products please visit https://www.mersoft.com

Setup instructions for Mersoft Move and Mersoft Stream

The below instructions can be used as a guide to setup Mersoft Move and Mersoft Stream, however for more detail please visit the Mersoft website.

  1. Download Mersoft Move: https://s3.amazonaws.com/install.move.mersoft.com/move.tar.gz
  2. Install with command: tar xzf move.tar.gz
  3. Start Mersoft Move:
    • cd move
    • ./move.sh start
  4. Download Mersoft stream: https://s3.amazonaws.com/install.move.mersoft.com/stream-1.4.0-linux.tar.gz
  5. Install with command: tar xzf stream-1.4.0-linux.tar.gz
  6. Add license key by editing the file stream/conf/env.js
    • Under the line, "global.authorization_keys = ["STREAMDEMO2018"];"
    • Add the license key
    • global.license_key = "XXXXXX"
    • Where XXXX is the license key provided.
  7. Start Mersoft Stream
    • cd stream
    • ./stream.sh start
  8. Edit the public/moveSecurity.js and replace the IP addresses on lines 3 and 4 with the server's IP address
  9. Visit the following URL's and accept the certificate
  10. Navigate to the URL https://SERVER_IP:4443/static/index.html to test

Commander™ setup

Tenant environment settings

  • Authentication code: Authentication code as generated from the Mersoft server setup
  • Stream server: Mersoft stream server (Ex. https://SERVER_IP:4443)
  • Web socket server: Mersoft stream server (ex. wss://SERVER_IP:3443/ws)

Tenant environment settings

Figure 1 - Tenant environment settings

Livestream video widget setup

Entity setup

For each camera that will be linked to a Livestream Widget a Static endpoint with data type 'Livestream video' must be created in Entity management. The value of the Static endpoint should be the address of the camera (rtsp://192.168.0.1) as specified in Mersoft.

  1. In Entity management go to the Entity group where the endpoints should be created.
  2. Create an endpoint with Entity sub-type Static.
  3. Change data type to Livestream video.
  4. Set video URL to URL as retrieved from Mersoft server.

Widget subscription

A Livestream widget must be added for each camera

  1. Open the Dashboard view where the Livestream widget must be added.
  2. Change the view to Design mode.
  3. Drop a Livestream widget onto the view.
  4. Drop the static endpoint onto the widget to confirm the subscription.

The following properties are can be set for each Livestream widget:

  • Auto-play enabled : If this property is set then the video will automatically play when the Dashboard view is opened, otherwise the user will have to click on the video to start playback
  • Show timer – Show timer on the widget that counts down until the timeout is reached.
  • Timeout duration (Min) – Time until Live video is stopped, specified in minutes.