Parameters

    Parameters


    Article summary


    title: Parameters

    version: 0.15.0
    layout: default
    sdk: core

    # Parameters Module

    Version Parameters 0.15.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:

    RoleCapability
    usesxrn: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
    SecondScreenEvent



    Was this article helpful?

    What's Next