Considerations and best practices

Last update: 2023-10-02

To use TVSDK most effectively, you should consider certain details of its operation and follow certain best practices.


Remember the following information when using TVSDK:

  • Adobe Primetime does not work on emulators or simulators.

    You must use real devices for testing.

  • Playback is supported only for HTTP Live Streaming (HLS) content.

  • Main video content can be multiplexed, where video and audio streams are in the same rendition, or non multiplexed, where video and audio streams are in separate renditions.

  • The TVSDK API is implemented in ActionScript.

  • Video playback requires the Adobe Video Engine (AVE). This affects how and when media resources can be accessed:

    • Closed captioning is supported to the extent provided by the AVE.

    • Depending on encoder precision, the actual encoded media duration might differ from the durations that are recorded in the stream resource manifest.

      There is no reliable way to resynchronize between the ideal virtual timeline and the actual playout timeline. Progress tracking of the stream playback for ad management and Video Analytics must use the actual playout time, so reporting and user interface behavior might not precisely track the media and advertisement content.

    • The incoming user agent name for all HTTP requests from TVSDK on this platform is assigned the following string pattern:

      "Adobe Flash Player"

Best practices

Here are the recommended practices for TVSDK:

  • Use HLS version 3.0 or above for program content.

  • For TVSDK 1.4 for DHLS, lazy ad loading is enabled by default.

    For content with no pre-roll or mid-roll, you can use AdvertisingMetadata.delayAdLoading to accelerate content loading even more.

On this page