View source for Digital Measurement Interruption Scenarios

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|US DCR & DTVR}}  {{CurrentBreadcrumb}}
[[Category:Digital]]

Interrupt scenarios are use cases that lead to interruption in content (audio / video) playback. App developers should watch for these use cases and implement the Nielsen AppSDK in a way that AppSDK does accurate measurement. There are various interrupt scenarios which app dev should take care of
*Pause / Play
*Network loss (Wi-Fi / Airplane / Cellular)
*Call Interrupt ( SIM or Third party Skype / Hangout call)
*Alarm Interrupt
*Content Buffering
*Lock / Unlock device (Video players only)
*App going Background / Foreground (Only video players without PIP mode support )
*Channel / Station Change Scenario
*Unplugging of headphone

== Interrupt scenarios for video ==
There are various interrupt scenarios which a video app dev should take care of
=== Pause / Play ===
*Call stop as soon as video is paused and withhold sending the playhead position.
*Once the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.
=== Network loss (Wi-Fi / Airplane / Cellular) ===
*Call stop as soon as network is lost and withhold sending the playhead position.
*Once the Wi-Fi is ON / Airplane is OFF / Cellular network is ON and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.
=== Call Interrupt ( SIM or Third party Skype / Hangout call) ===
*Call stop as soon as a SIM or Skype / Hangout call is observed and withhold sending the playhead position.
*Once the SIM or Skype / Hangout call ends and the video has resumed, call loadMetadata and sendID3 / playheadPosition
=== Alarm Interrupt ===
*Call stop as soon as a device or an in-app alarm is observed and withhold sending the playhead position.
*Once the device or in-app alarm ends / is acknowledged and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.
=== Content Buffering ===
*App dev should withhold sending the playhead position as soon as player starts content buffering
*Once the buffering ends and the audio has resumed, call sendID3 / playheadPosition.
=== Lock / Unlock device ===
*Call stop as soon as the device is locked and withhold sending the playhead position.
*Once the device is unlocked and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.
=== App going Background / Foreground (when PIP mode is not supported / enabled) ===
*Call stop as soon as the app goes to background and withhold sending the playhead position.
*Once the app resumes to foreground and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.
=== Channel / Station change from current channel / station to other ===
*Call stop for the current channel / station as soon as it is changed and withhold sending its playhead position.
*As soon as new channel / station starts, call loadMetadata and sendID3 / playheadPosition for the channel / station in that order.
=== Unplugging of headphone ===
*Call stop as soon as the video stops playback because of unplugging of headphone and withhold sending its playhead position.
*As soon as video resumes, call loadMetadata and sendID3 / playheadPosition

== Interrupt Scenarios for radio / audio ==
Radio / audio app dev must trigger / stop the API calls as mentioned below, in the respective interrupt scenario.
=== Pause / Play ===
*Call stop as soon as audio is paused and withhold sending the playhead position.
*Once the audio has resumed, call loadMetadata and playheadPosition in that order.
=== Network loss (Wi-Fi / Airplane / Cellular) ===
*Call stop as soon as network is lost and withhold sending the playhead position.
*Once the Wi-Fi is ON / Airplane is OFF / Cellular network is ON and the audio has resumed, call loadMetadata and playheadPosition in that order.
=== Call Interrupt ( SIM or Third party Skype / Hangout call) ===
*Call stop as soon as a SIM or Skype/Hangout call is observed and withhold sending the playhead position.
*Once the SIM or Skype/Hangout call ends and the audio has resumed, call loadMetadata and playheadPosition in that order.
=== Alarm Interrupt ===
*Call stop as soon as a device or an in-app alarm is observed and withhold sending the playhead position.
*Once the device or in-app alarm ends / is acknowledged and the audio has resumed, call loadMetadata and playheadPosition in that order.
=== Content Buffering ===
*Withhold sending the playhead position as soon as the player starts content buffering.
*Once the buffering ends and the audio has resumed, call playheadPosition.
=== Channel / Station Change Scenario ===
*Call stop for the current channel / station as soon as it is changed and withhold sending its playhead position.
*As soon as new channel / station starts, call loadMetadata and playheadPosition for the channel / station in that order.
=== Unplugging of headphone ===
*Call stop when the audio stops playback because of unplugging of headphone and withhold sending its playhead position.
*Once the audio has resumed, call loadMetadata and playheadPosition in that order.
<blockquote>'''Note:''' Lock / Unlock device and app going Background / Foreground are not an interrupt scenario for radio / audio clients unless the audio stops.</blockquote>