Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}} Category:Digital Category:Android SDK API Reference Stops measure..."

2017-05-21T07:28:28Z

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

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}}
[[Category:Digital]]
[[Category:Android SDK API Reference]]
Stops measurement progress. Call <code>stop()</code> in following situations:
*When user initiates content pause and the content can be resumed from the same position.
*When current content is changing, such as a channel change (Call <code>stop()</code> on current content and call [[play()]] & [[loadMetadata()]] on new content).
*When content is interrupted by external app or process (phone call, Network loss + empty buffer, power / standby activated, alarm).
**For audio only: Android has two kinds of audio focus requests – soft and hard.
***Soft requests are usually temporary interruptions, such as alarm, incoming call on some systems which only ‘duck’ or lower the volume but do not indicate that audio focus was lost. These are acceptable to not call <code>stop()</code> on.
***Hard requests are usually streaming apps like YouTube, Pandora, etc. which should properly indicate the audio focus was lost – <code>stop()</code> can be called for those.
***Another case to be covered for hard requests is when the camera’s video record is engaged. This, often, will interrupt audio playback. However on Android, there is no guarantee that it will come as a hard request across all devices.
***When an ad ends.
*When content has completed (Call <code>stop()</code> followed by either a postroll ping or an [[end()]] call).
*Anytime when whole screen is occluded (for video content)

== Syntax ==
<syntaxhighlight lang="java">
public void stop()
</syntaxhighlight>

== Input Parameters ==
{| class="wikitable"
|-
! Parameter !! Description
|-
| None ||
|}

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

== Notes ==
*It is very important that the SDK calls <code>stop()</code> whenever necessary.
In case of a missing <code>stop()</code> call, App SDK identifies the change to next [[play()]] and inserts a <code>stop()</code> call (functionally in the background). This allows the downstream systems to track the <code>stop()</code> calls.

stop() - Revision history

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Android SDK API Reference}} {{CurrentBreadcrumb}} Category:Digital Category:Android SDK API Reference Stops measure..."