App Control

​

Introduction

App Control enables seamless integration of deep-linking and app control functions for partners. This documentation outlines the method’s syntax, parameters, and behavior for launching applications on Titan OS.

​

Getting Started

To use the App Control API, you must include the following script in your application:

<script
  src="https://app.titanos.tv/app2app/bridge.umd.js"
  type="text/javascript"
/>

​

Syntax

TitanOS.launchApp(code: string, query?:string): Promise<void>

​

Parameters

• code (string, required): The universal identifier of the application to be launched. Example: netflix, primevideo, youtube, etc. You can find these codes in the Partner Portal under the Resources -> App Control section.
• query (string, optional): A deeplink or query string unique to each app, passed to the application upon launching. This can be used to navigate to specific content within the app.

​

Behavior

1. Application Validation: With the App code, we validate if the app exists and is available in the user’s current country market and TV model.
2. Launching the Application:
   • Success: If the application is valid and available, it is launched with the optional query. The promise resolves successfully.
   • Failure: If the application is not valid or unavailable, the promise is rejected with a specific error code.

​

Error Handling

The promise may be rejected with an error object containing:

• code (string): A machine-readable error code indicating the type of error.
• message (string): A human-readable message providing more details about the error.

​

Error Codes

• APP_NOT_FOUND: The application specified by code does not exist.

​

Example Usage

// Launching an app without query
TitanOS.launchApp("netflix")
  .then(() => {
    console.log("Netflix launched successfully.");
  })
  .catch((error) => {
    console.error(`Error (${error.code}): ${error.message}`);
  });

// Launching an app with query or deeplink
TitanOS.launchApp("youtube", "https://youtu.be/dQw4w9WgXcQ")
  .then(() => {
    console.log("YouTube launched with the specified video.");
  })
  .catch((error) => {
    console.error(`Error (${error.code}): ${error.message}`);
  });