play: Difference between revisions

From Engineering Client Portal

No edit summary
No edit summary
Line 44: Line 44:
};
};
</syntaxhighlight>
</syntaxhighlight>
|}
== Output Parameters ==
{| class="wikitable"
|-
!
Output Parameters (Return value) !! Description
|-
| void ||
|}
|}

Revision as of 06:06, 21 May 2017

Engineering Portal breadcrumbArrow.png Digital breadcrumbArrow.png iOS SDK API Reference breadcrumbArrow.png play

The SDK is started by calling the play API with the channelName parameter and mediaURL parameters.

  • Pass the channelName parameter with the channel name when
    • The user taps the Play button on the player (OR)
    • An audio stream restarts automatically
  • Pass descriptive stream information through this parameter
    • The channel name field is a 32-character field containing the name of the program or feed such as: “WENZ-FM”, “The Dove-Tampa”, “Hot 107.9”, or “Aerosmith Radio”.
    • channelName in play API is required for Digital in TV Ratings (DTVR) and can have freeform text.
    • channelName parameter is optional for Digital Audio and Digital Content Ratings (DCR).
  • mediaURL is an optional parameter
    • This is the URL for the content (media) that is being played.
    • If mediaURL is not available, pass an empty value.

Syntax

[endpoint]/[appid]/[sessionID]/a?b=[payload]

Input Parameters

Parameter Description
channelName Free-form text up to 32 characters
mediaURL Media URL value for the content that is being played

DTVR

NSDictionary *appInformation = @
{
  @channelName:@TheMovieTitle,
  @mediaURL:@””
};

Digital Audio and DCR

NSDictionary *appInformation = @
{
  @channelName:@””,
  @mediaURL:@http://www.nielseninternet.com/BBB/prog_index.m3u8″
};

Output Parameters

Output Parameters (Return value) !! Description

void