Application Development Basics

For external web server placement, specify the URL in theweb_urlproperty of manifest.json, same as static files. For USB drive or monitor built-in storage placement, place files in the /media/ folder. The monitor will access them automatically without specifying a property in manifest.json.

Example Video File Placemen

file://localhost/media/<file_name>.mp4

autorun.txt is written based on JSON key/value format. All values are strings, and only the auid property is mandatory. For details and optional properties, see below. You can also specify HTML5 application operations (launch, install, delete).

autorun.txt Structure and Properties

Structure

USB:/ 
/sony/
　　├ autorun.txt // auid
　　├ apps/webapps/
　　　　　　　├ <app name 1>/app/manifest.json // auid
　　　　　　　├ <app name 2>/app/manifest.json // auid_1
　　　　　　　├ :

Example

{
  "action": "auid",              // auid: Launch / copyapp: Install / removeapp: Delete
  "auid": "<app ID>",            // Mandatory. Application ID to launch
  "copyapp": {
    "app": "<app ID>",           // Application ID to install to built-in storage
    "media": "nocopy",           // copy / sync / nocopy
    "mode": "confirm",           // confirm / auto / dryrun
    "startup_uri": "<app ID>",   // Application ID for power-linked launch
    "home_menu_app": "false"     // Home menu icon display true / false
  },
  "removeapp": {
    "app": "<app ID>",           // Application ID to delete
    "media": "keep",             // keep / remove
    "mode": "confirm"            // confirm / auto / purge
  }
}

{
  "action": "auid",              // auid: Launch / copyapp: Install / removeapp: Delete
  "auid": "<app ID>",            // Mandatory. Application ID to launch
  "copyapp": {
    "app": "<app ID>",           // Application ID to install to built-in storage
    "media": "nocopy",           // copy / sync / nocopy
    "mode": "confirm",           // confirm / auto / dryrun
    "startup_uri": "<app ID>",   // Application ID for power-linked launch
    "home_menu_app": "false"     // Home menu icon display true / false
  },
  "removeapp": {
    "app": "<app ID>",           // Application ID to delete
    "media": "keep",             // keep / remove
    "mode": "confirm"            // confirm / auto / purge
  }
}

Control Properties for Built-in Storage Placement

1. “copyapp”

When placing HTML5 applications in the monitor’s built-in storage, you can combine the following properties for more detailed control of installation behavior.

{
  "action": "copyapp",
  "auid": "<app ID>",
  "copyapp": {
    "app": "<app ID>",
    "startup_uri": "<app ID>"  // Optional. Specify when using power-linked launch
  }
}

{
  "action": "copyapp",
  "auid": "<app ID>",
  "copyapp": {
    "app": "<app ID>",
    "startup_uri": "<app ID>"  // Optional. Specify when using power-linked launch
  }
}

2. “removeapp”

You can control uninstallation behavior using the following properties.

manifest.json specifies application information such as auid, display name, launch URL, and splash image.
The manifest file must be named “manifest.json”.

Example　web_url

{
  "name": {
    "default": "en_US",
    "en_US": "<app display name>"　　// Application name displayed in Home menu
  },
  "auid": "com.example.myapp",　　// Reverse domain format (e.g., http://example.com → com.example)
  "version": "1.0",
  "manifest_version": "1.0",
  "app": {
    "launch": {
      "web_url": "http://example.com/myapp"　// URL specification
    }
  },
  "splash": "splash.jpg",
  "minimum_web_platform_version": "1.0"
}

{
  "name": {
    "default": "en_US",
    "en_US": "<app display name>"　　// Application name displayed in Home menu
  },
  "auid": "com.example.myapp",　　// Reverse domain format (e.g., http://example.com → com.example)
  "version": "1.0",
  "manifest_version": "1.0",
  "app": {
    "launch": {
      "web_url": "http://example.com/myapp"　// URL specification
    }
  },
  "splash": "splash.jpg",
  "minimum_web_platform_version": "1.0"
}

Example　local_path

{
  "name": {
    "default": "en_US",
    "en_US": "<app display name>"　　 // Application name displayed in Home menu
  },
  "auid": "<app ID>",　
  "version": "1.0",
  "manifest_version": "1.0",
  "app": {
    "launch": {
      "local_path": "file://localhost/doc/index.html"  // Path to HTML file launched via USB or built-in storage
    }
  },
  "splash": "splash.jpg",
  "minimum_web_platform_version": "1.0"
}

{
  "name": {
    "default": "en_US",
    "en_US": "<app display name>"　　 // Application name displayed in Home menu
  },
  "auid": "<app ID>",　
  "version": "1.0",
  "manifest_version": "1.0",
  "app": {
    "launch": {
      "local_path": "file://localhost/doc/index.html"  // Path to HTML file launched via USB or built-in storage
    }
  },
  "splash": "splash.jpg",
  "minimum_web_platform_version": "1.0"
}

manifest.json Property Details

Key event

"app": {
  "attachkeys": [
    "VK_HOME",   // Home button
    "VK_CH_UP",  // Channel up
    "VK_CH_DOWN"  // Channel down
  ]
},

"app": {
  "attachkeys": [
    "VK_HOME",   // Home button
    "VK_CH_UP",  // Channel up
    "VK_CH_DOWN"  // Channel down
  ]
},

document.onkeydown = function(e) {
  if (e.keyCode === VK_HOME) {
    // Please implement a home key behavior here.
  }
}

document.onkeydown = function(e) {
  if (e.keyCode === VK_HOME) {
    // Please implement a home key behavior here.
  }
}

Example for 403, 500, and Timeout Errors

An example of page configuration for error handling is shown below.

[
  {“status_code” : “403”, “path” : “http://example.com/doc/403.html”},
  {“status_code” : “500”, “path” : “file://localhost/doc/500.html”},
  {“status_code” : “timeout”, “path” : “file://localhost/doc/timeout.html”}
]

[
  {“status_code” : “403”, “path” : “http://example.com/doc/403.html”},
  {“status_code” : “500”, “path” : “file://localhost/doc/500.html”},
  {“status_code” : “timeout”, “path” : “file://localhost/doc/timeout.html”}
]

Example

• application/x-decimated-video　Display HDMI input video within the HTML5 application
• application/x-multicast-video　Multicast video playback
• application/x-4k-photo　Display high-quality images

Example

• sony.tv.DirectoryReader　 Retrieve file list in directory
• sony.tv.systemevents　Detect monitor system events (input switching, power status, etc.)
• sony.tv.picturemode 　Get and change picture mode