Parameters Module


Version Parameters 1.0.0

Table of Contents

Usage

To use the Parameters module, you can import it into your project from the Firebolt SDK:

import { Parameters } from '@firebolt-js/sdk'

Overview

Methods for getting initialization parameters for an app cold launch.

Methods

initialization

Returns any initialization parameters for the app, e.g. initialial NavigationIntent.

function initialization(): Promise<AppInitialization>

Promise resolution:

AppInitialization

Capabilities:

Role Capability
uses xrn:firebolt:capability:lifecycle:state

Examples

Default Example

JavaScript:

import { Parameters } from '@firebolt-js/sdk'

Parameters.initialization()
    .then(init => {
        console.log(init)
    })

Value of init:

{
	"lmt": 0,
	"us_privacy": "1-Y-",
	"discovery": {
		"navigateTo": {
			"action": "entity",
			"data": {
				"entityId": "abc",
				"entityType": "program",
				"programType": "movie"
			},
			"context": {
				"source": "voice"
			}
		}
	}
}
JSON-RPC:

Request:

{
	"jsonrpc": "2.0",
	"id": 1,
	"method": "Parameters.initialization",
	"params": {}
}

Response:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"lmt": 0,
		"us_privacy": "1-Y-",
		"discovery": {
			"navigateTo": {
				"action": "entity",
				"data": {
					"entityId": "abc",
					"entityType": "program",
					"programType": "movie"
				},
				"context": {
					"source": "voice"
				}
			}
		}
	}
}

Types

AppInitialization

type AppInitialization = {
  us_privacy?: string                  // The IAB US Privacy string.
  lmt?: number                         // The IAB limit ad tracking opt out value.
  discovery?: {
    navigateTo?: NavigationIntent      // A Firebolt compliant representation of a user intention to navigate to a specific place in an app.
  }
  secondScreen?: {
    launchRequest?: SecondScreenEvent  // An a message notification from a second screen device
  }
}

See also:

HomeIntent | LaunchIntent | EntityIntent | PlaybackIntent | SearchIntent | SectionIntent | TuneIntent | PlayEntityIntent | PlayQueryIntent SecondScreenEvent