setPlayheadPosition() - Revision history

Admin at 23:51, 29 May 2019

2019-05-29T23:51:03Z

← Older revision		Revision as of 23:51, 29 May 2019
Line 7:		Line 7:
	'''When streaming VOD (Video On Demand)''', the playhead position is the current location of the player from the beginning of the asset in seconds;		'''When streaming VOD (Video On Demand)''', the playhead position is the current location of the player from the beginning of the asset in seconds;
	'''When streaming live content''', the playhead position passed to the <code>AppSdk</code> is the current Unix timestamp (seconds since Jan-1-1970 UTC).		'''When streaming live content''', the playhead position passed to the <code>AppSdk</code> is the current Unix timestamp (seconds since Jan-1-1970 UTC).
	~~'''For Digital Audio streaming Live or On Demand content,''' the playhead position passed to the <code>AppSdk</code> is the current Unix timestamp (seconds since Jan-1-1970 UTC)~~

	== Syntax ==		== Syntax ==

Admin at 19:33, 30 November 2018

2018-11-30T19:33:34Z

← Older revision		Revision as of 19:33, 30 November 2018
Line 6:		Line 6:
	*Not receive playhead updates when the content playback is paused or stopped.		*Not receive playhead updates when the content playback is paused or stopped.
	'''When streaming VOD (Video On Demand)''', the playhead position is the current location of the player from the beginning of the asset in seconds;		'''When streaming VOD (Video On Demand)''', the playhead position is the current location of the player from the beginning of the asset in seconds;
	'''When streaming live content''', the playhead position passed to the <code>AppSdk</code> is the current UTC ~~time in seconds~~.		'''When streaming live content''', the playhead position passed to the <code>AppSdk</code> is the current Unix timestamp (seconds since Jan-1-1970 UTC).
	'''For Digital Audio streaming Live or On Demand content,''' the playhead position passed to the <code>AppSdk</code> is the current UTC ~~time in seconds.~~		'''For Digital Audio streaming Live or On Demand content,''' the playhead position passed to the <code>AppSdk</code> is the current Unix timestamp (seconds since Jan-1-1970 UTC)

	== Syntax ==		== Syntax ==
Line 19:		Line 19:
	! Parameter !! Description		! Parameter !! Description
	\|-		\|-
	\| playhead position \|\| An Integer value representing the time in content in seconds (VOD – Video On Demand) or the current UTC ~~time in seconds~~ (live).		\| playhead position \|\| 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: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}} Category:Digital Category:Android SDK API Reference For situation..."

2017-05-21T07:28:02Z

Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}} Category:Digital Category:Android SDK API Reference For situation..."

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}}
[[Category:Digital]]
[[Category:Android SDK API Reference]]
For situations where CMS data is used in conjunction with Nielsen’s SDK, the application needs to call the <code>setPlayheadPosition</code> in the SDK every one second. For proper reporting, the SDK should
*Receive a playhead position update every one second on the playback of content.
*Not receive playhead updates when the content playback is paused or stopped.
'''When streaming VOD (Video On Demand)''', the playhead position is the current location of the player from the beginning of the asset in seconds;
'''When streaming live content''', the playhead position passed to the <code>AppSdk</code> is the current UTC time in seconds.
'''For Digital Audio streaming Live or On Demand content,''' the playhead position passed to the <code>AppSdk</code> is the current UTC time in seconds.

== Syntax ==
<syntaxhighlight lang="java">
public void setPlayheadPosition(long position)
</syntaxhighlight>

== Input Parameters ==
{| class="wikitable"
|-
! Parameter !! Description
|-
| playhead position || An Integer value representing the time in content in seconds (VOD – Video On Demand) or the current UTC time in seconds (live).
|}

== 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. The client app can schedule a one-second-period timer to send the playhead position in the following manner:

=== Scheduling a one-second-period timer ===
<syntaxhighlight lang="java">
//The client app can schedule a one-second-period timer to send the playhead position in the following manner.
class PlayerPositionTracker extends Thread implements Runnable
{
public static final int POSITON_INTERVAL = 1000;
@Override
public void run()
{
while (true)
{
long t = 0;
if (isPlaying)
{
if (isLive) // Live – dependent on media player
{
t = (c.getTimeInMillis()/ 1000;
if (mAppSdk != null)
mAppSdk.setPlayheadPosition(t);
}
else // VOD
{
t = mMediaPlayer.getCurrentPosition() / 1000;
if (mAppSdk != null)
mAppSdk.setPlayheadPosition(t);
}
}
Thread.sleep(POSITON_INTERVAL);
}
}
}
</syntaxhighlight>