Install and Run an Application

Estimated reading time: 5 minutes

You can install your applications to BRAVIA Professional Display, and BRAVIA Professional Display can launch an application as a start-up application and replace the default home application with your application.

Install an Application

You need to update autorun.txt to install your application to BRAVIA Professional Display. autorun.txt is located in the USB /sony directory. The following properties should be set to install and identify an application.

  • action should be set as “copyapp”.
  • auid should be set to identify an application.
  • copyapp -> app should be set to the above auid. This auid is used to identify which application in the USB storage is to be installed.
  • copyapp -> startup_uri should be set to the above auid. BRAVIA Professional Display sets this auid to identify the application for the start-up application.

Please visit autorun.txt for details of autorun.txt.

Example

The following sample autorun.txt shows the minimum definition to install an application to BRAVIA Professional Display.

{
  "action": "copyapp",
  "auid": "net.sony.tv.sample.myapp_1",
  "copyapp": {
    "app": "net.sony.tv.sample.myapp_1",
    "startup_uri": "net.sony.tv.sample.myapp_1"
  }
}

Install Media Contents

When installing an application to BRAVIA Professional Display, media contents which are stored in the USB:/media directory can also be installed into BRAVIA Professional Display. Installed media contents are available in an installed application.

If an application uses a video content stored in /media/video1.mp4, it can access the video file by using file scheme as below.

<video src="file://localhost/media/video1.mp4"/>

Manage Installed Media Contents[1]

[1] This feature is supported from WebAppRuntime v1.2.65.8 and later.

Once an application and media contents are installed to BRAVIA Professional Display, you can replace or sync installed media contents with the /media directory of the USB storage without any application code. You need only media contents in the /media directory and /sony/autorun.txt. The /sony/apps directory is not needed.

  • Sync media contents with the /media directory of the USB storage. In this case, all installed media contents are synchronized with the /media directory of the USB storage. If video1.mp4 is installed but the /media directory does not include video1.mp4, the installed video1.mp4 is removed.
    • autorun.txt
       {
           "action": "copyapp",
           "copyapp": {
               "app": "define auid to be installed" ,
               "media":"sync"
           }
       }
      
  • Copy or overwrite media contents with the /media directory of the USB storage In this case, all installed media contents are overwritten with the /media directory of the USB storage. However installed contents are not removed even if the /media directory does not include the same file name.
    • autorun.txt
       {
           "action": "copyapp",
           "copyapp": {
               "app": "define auid to be installed" ,
               "media":"copy"
           }
       }
      

Run an Application as the Start-up Application in Pro mode

An application installer automatically sets mandatory properties to launch an application in Pro mode. In the above example, the "startup_uri" property is automatically set in the installation process.

  1. Turn to Pro settings mode
  2. Choose Initial source and volume Initial input source Start-up app
  3. Confirm the value of "startup_uri" is filled automatically. The "startup_uri" property of the installed application is applied here.
  4. Start Pro mode. BRAVIA Professional Display reboots automatically.
  5. BRAVIA Professional Display starts in Pro mode and the application starts as start-up application.

Run an Application as a Home Application in Pro mode; “Home Key Behaviour” Customization

By default, BRAVIA Professional Display launches the original home menu application when the user presses the HOME key. However you can change the behavior. In Pro settings, there is a menu item named “Home Key Behaviour”.

By using this feature, you can replace BRAVIA Professional Display home application with another application. You can customize the Display behavior as follows:

No. Menu Behavior
1 Standard Menu (Default) Launch BRAVIA Professional Display home application
2 Custom Menu Launch an application specified by “Start-up app” in Pro setting
3 Custom & Standard Menus Launch the application, BRAVIA Professional Display home and the last input signal (e.g. HDMI1) in turn
4 Installed app Launch an installed Android APK
  1. Turn to Pro settings mode.
  2. Settings Home key behaviour Custom menu
  3. Confirm that the value of "startup_uri" is filled automatically. The "startup_uri" of installed application is applied here.
  4. Start Pro mode. BRAVIA Professional Display reboots automatically
  5. BRAVIA Professional Display starts in Pro mode and the application starts as the Home application.

In this way, you can integrate an application.

Uninstall an Application

To uninstall your Web Application from BRAVIA Professional Display, the action property in autorun.txt should be set as removeapp.

To uninstall an application from BRAVIA Professional Display, the action property in autorun.txt should be set as removeapp.

Please visit autorun.txt for details.

Last modified: 25 Dec 2019