play: Difference between revisions

From Engineering Client Portal

No edit summary
(- Digital Audio)
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK Reference}}  {{CurrentBreadcrumb}}
{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK API Reference}}  {{CurrentBreadcrumb}}
[[Category:Digital]]
[[Category:Digital]]
[[Category:iOS SDK Reference]]
[[Category:iOS SDK API Reference]]


The SDK is started by calling the <code>play</code> API with the <code>channelName</code> parameter and <code>mediaURL</code> parameters.
The SDK is started by calling the <code>play</code> API with the <code>channelName</code> parameter and <code>mediaURL</code> parameters.
*Pass the <code>channelName</code> parameter with the channel name when
* <code>channelName</code> is an optional parameter you can pass when:
**The user taps the '''Play''' button on the player (OR)
**The user taps the '''Play''' button on the player (OR)
**An audio stream restarts automatically
**An audio stream restarts automatically
*Pass descriptive stream information through this parameter
*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”.
**<code>channelName</code> in play API is required for Digital in TV Ratings and can have free form text.
**<code>channelName</code> in play API is required for [[Digital in TV Ratings |Digital in TV Ratings (DTVR)]] and can have freeform text.
**<code>channelName</code> parameter is optional for [[Digital Audio]] and [[Digital Content Ratings |Digital Content Ratings (DCR)]].
*mediaURL is an optional parameter
**This is the URL for the content (media) that is being played.
**If <code>mediaURL</code> is not available, pass an empty value.


== Syntax ==
== Syntax ==
<syntaxhighlight lang="swift">[endpoint]/[appid]/[sessionID]/a?b=[payload]</syntaxhighlight>
<syntaxhighlight lang="swift"> [nielsenAppApi play:(JSONObject channelInfo)];</syntaxhighlight>


== Input Parameters ==
== Input Parameters ==
{| class="wikitable"
{| class="wikitable"
|-
|-
! Parameter !! Free-form text up to 32 characters
! Parameter !! Description
|-
|-
| channelName || Example
| channelName || Free-form text up to 32 characters
|-
|-
| mediaURL || Media URL value for the content that is being played
| mediaURL || Media URL value for the content that is being played
Line 31: Line 26:
NSDictionary *appInformation = @
NSDictionary *appInformation = @
{
{
   @”channelName”:@”TheMovieTitle”,
   @"channelName":@"TheMovieTitle",
   @”mediaURL”:@””
   @"mediaURL":@""
};
};
</syntaxhighlight>
</syntaxhighlight>


'''Digital Audio and DCR'''
'''DCR'''
<syntaxhighlight lang="swift">
<syntaxhighlight lang="swift">
NSDictionary *appInformation = @
NSDictionary *appInformation = @
{
{
   @”channelName”:@””,
   @"channelName":@"",
   @”mediaURL”:@”http://www.nielseninternet.com/BBB/prog_index.m3u8″
   @"mediaURL":@"http://www.nielseninternet.com/BBB/prog_index.m3u8"
};
};
</syntaxhighlight>
</syntaxhighlight>
|}
== Output Parameters ==
{| class="wikitable"
|-
! Output Parameters (Return value) !! Description
|-
| void ||
|}
|}

Latest revision as of 22:22, 14 May 2019

Engineering Portal / Digital / iOS SDK API Reference / play

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

  • channelName is an optional parameter you can pass when:
    • The user taps the Play button on the player (OR)
    • An audio stream restarts automatically
  • Pass descriptive stream information through this parameter
    • channelName in play API is required for Digital in TV Ratings and can have free form text.

Syntax

 [nielsenAppApi play:(JSONObject channelInfo)];

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":@""
};

DCR

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

Output Parameters

Output Parameters (Return value) Description
void