Prerequisites

Before you follow the steps below, make sure you have installed all the required prerequisites in your dev PC - Node.js , npm, Lightning-CLI

• Download and install VSCode IDE (code editor) - https://code.visualstudio.com/download
• Download and install Node.js and npm  - https://nodejs.org/en/download/
• Install Lightning-CLI globally in your dev PC      

$ npm install -g @lightningjs/cli

reference image for Lightning-CLI install

Build instructions

• Create Lightning refapp dev build

  1. pull code from source repo using below command

     $ git clone https://github.com/LibertyGlobal/refapp.git

  2. goto refapp directory

     $ cd refapp

  3. install the NPM dependencies by running below command

     $ npm install

  4. run copyAssets.sh command to create static folder and copy images, json files etc

     $./copyAssets.sh

  5. run below command for testing in browser. 

$ lng dev

refer below screenshots for reference

reference images for build instructions-1

reference images for build instructions-2

once npm install complete, you will get message at the end "Do you want us to automatically check for old Lightning-SDK imports and update them in your project files? y/n

press n and hit enter button because on pressing y it gets hanged or stuck, in this case press ctrl+c 

reference images for build instructions-3

reference images for build instructions-4

Running refapp

by default vscode launch generated url on chrome browser in dev pc.

reference image for running app on browser

• Create dist (build)

  1. run below command to make build.

$ lng dist

reference image for dist creation

Hosting Lighting refapp

1. copy the lighting build app from dist folder.
2. host build folder into any http server.
3. test the hosted application on browser 

Lighting refapp integration

• Lighting refapp integration into rdk-generic-hybrid-image-raspberrypi:

1. login into raspberrypi : $ssh root@<<IP address>>
2. cd /lib/rdk/
3. add startup_app_conf variable into referenceApp.sh config file 
   • startup_app_conf=/opt/residentapp.conf 

4. add below line to avoid loading default app  

url="http://192.168.0.106:8080/"
echo $url

5. replace exting url https://px-apps.sys.comcast.net/lightning_apps/SwitcherApp/dist/index.html in /opt/residentapp.conf with lighting app url which is hosted on server

for example your server providing url http://192.168.56.1:8080

6. reboot the box .

After reboot app come up with a splash screen. Lighting application will launch instead of switcher app. Main menu screen is displayed which allows users to launch apps, vod, and play video content.

RefApp Video Playback

• RDK 4.0 (rdk-generic-hybrid-image) Vs LGI  RefApp (rdk-generic-hybrid-refapp-image)

Dependencies

• Lightning RefApp on Accelerator

  • Uses lighting sdk media player to play video, verified video playback using mp4 and HLS streams. 
    • Tested mp4 source: http://clips-media-aka.warnermediacdn.com/cnn/clips/2021-01/79895-97f21462b4db4236abcbd68a581[…]remarks-vpx-primary-58581-79895-1920x1080_8000k.mp4 
    • Tested hls source: //cdn.metrological.com/hls/greenland720.m3u8
  • Lightning (a javascript TV app development framework) refapp is a web based app, which runs on browser (supports WebGL). To run this wpe framwork or rdkbrowser2 is required.
  • sessionmanager, rmfstreamer, spark environment, nodejs and LGI based IP player not required.

• Lightning RefApp on rdk-generic-hybrid-refapp

  • uses rmfstreamer with sessionmanager and spark environment to play video streams (hls/dash) using (aamp and Liberty IPplayer)