ShaneHartman: updated input parameter to reflect spec for live playhead position

2019-01-10T18:35:33Z

updated input parameter to reflect spec for live playhead position

← Older revision		Revision as of 18:35, 10 January 2019
Line 32:		Line 32:
	! Parameter !! Description		! Parameter !! Description
	\|-		\|-
	\| playheadPos \|\| An Integer value representing the time in content in seconds.		\| playheadPos \|\| An Integer value representing the time in content in seconds (VOD – Video On Demand) or the current Unix timestamp (seconds since Jan-1-1970 UTC) (live).
	\|}		\|}

Admin at 04:05, 21 May 2017

2017-05-21T04:05:08Z

← Older revision		Revision as of 04:05, 21 May 2017
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]]

	For situations where CMS data is used in conjunction with Nielsen SDK the application needs to call the <code>playheadPosition</code> in the SDK every one second until a pause / stop. The playhead position is the current location in seconds of the playhead from the beginning of the asset.		For situations where CMS data is used in conjunction with Nielsen SDK the application needs to call the <code>playheadPosition</code> in the SDK every one second until a pause / stop. The playhead position is the current location in seconds of the playhead from the beginning of the asset.

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK Reference}} {{CurrentBreadcrumb}} Category:Digital Category:iOS SDK Reference For situations where CMS da..."

2017-05-21T03:24:42Z

Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK Reference}} {{CurrentBreadcrumb}} Category:Digital Category:iOS SDK Reference For situations where CMS da..."

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK Reference}} {{CurrentBreadcrumb}}
[[Category:Digital]]
[[Category:iOS SDK Reference]]

For situations where CMS data is used in conjunction with Nielsen SDK the application needs to call the <code>playheadPosition</code> in the SDK every one second until a pause / stop. The playhead position is the current location in seconds of the playhead from the beginning of the asset.

== Syntax ==
<syntaxhighlight lang="objective-c">
– (void) playheadPosition: (long long) playheadPos
</syntaxhighlight>

== Sending playheadposition for content ==
<syntaxhighlight lang="objective-c">
AVPlayer *player;
CMTime curTime=[player currentTime];
int pos = CMTimeGetSeconds(curTime);
[nAppApiObject playheadPosition:pos];
</syntaxhighlight>

== Sending playheadposition for ad ==
<syntaxhighlight lang="objective-c">
CMTime curTime=[adplayer currentTime];
long pos=CMTimeGetSeconds(curTime);
[nAppApiObject playheadPosition:pos];
</syntaxhighlight>

<blockquote>'''Note:''' In case the individual ad details are not available, send ad pod (presence) details through the [[loadMetadata]] & playhead position and through <code>playheadPosition</code>.</blockquote>

== Input Parameters ==
{| class="wikitable"
|-
! Parameter !! Description
|-
| playheadPos || An Integer value representing the time in content in seconds.
|}

== Output Parameters ==
{| class="wikitable"
|-
! Output Parameters (Return value) !! Description
|-
| Void ||
|}

== Notes ==
The player application must send the value of the playhead to the SDK every one second. The player application can schedule a timer with a one-second-period in a timer event and send the playhead position.

=== Buffering state ===
*Do not supply playhead position while the content is being buffered.
*If the content is in buffering state continuously for more than 30 seconds, call [[stop]] API.

=== Live Content ===
<syntaxhighlight lang="objective-c">
long long pos = [[NSDate date] timeIntervalSince1970];
[nAppApiObject playheadPosition:pos];
</syntaxhighlight>

=== On-demand Content ===
<syntaxhighlight lang="objective-c">
CMTime curTime=[player currentTime];
long pos=CMTimeGetSeconds(curTime);
[nAppApiObject playheadPosition:pos];
</syntaxhighlight>

=== Ad Content ===
<syntaxhighlight lang="objective-c">
CMTime curTime=[adplayer currentTime];
long pos=CMTimeGetSeconds(curTime);
[nAppApiObject playheadPosition:pos];
</syntaxhighlight>

<blockquote>'''Note:''' The playhead positions for ad and content should be maintained separately.</blockquote>
<blockquote>'''Note:''' If playhead is not available from audio / video measurement, allow the app to start a timer (1-5 seconds) and send playhead position to SDK based on the timer event. Once the actual playhead is available, let the app send the proper playhead position. This allows the SDK to calculate and provide a closer value for duration.</blockquote>

playheadPosition - Revision history

ShaneHartman: updated input parameter to reflect spec for live playhead position

Admin at 04:05, 21 May 2017

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|iOS SDK Reference}} {{CurrentBreadcrumb}} Category:Digital Category:iOS SDK Reference For situations where CMS da..."