|
| 1 | +--- |
| 2 | +name: HLS/DASH/Console Playback Failure |
| 3 | +about: Are you experiencing a failure when playing your streamed media? |
| 4 | +title: "[Playback Failure]" |
| 5 | +labels: Playback |
| 6 | +assignees: '' |
| 7 | + |
| 8 | +--- |
| 9 | + |
| 10 | +**NOTE:** This template is for failure to playback issues of HLS, DASH, and AWS console players. If the playback issue is related to GetMedia playback, please submit an issue on the [KVS Java Parser Library](https://github.com/aws/amazon-kinesis-video-streams-parser-library) repository. If the issue is related to HLS/DASH/Console, but the issue is not regarding a failure to playback (such as a latency issue or general question), please submit using the general question template. |
| 11 | + |
| 12 | +### Brief one-liner description of the issue: |
| 13 | +... |
| 14 | + |
| 15 | +### Please include the following details: |
| 16 | +- Problematic playback methods (HLS, DASH, and/or AWS Console), operating systems, browsers: |
| 17 | + - ... |
| 18 | +- Working playback methods (were you able to playback the stream using using any methods?), operating systems, browsers: |
| 19 | + - ... |
| 20 | +- Is the stream's data retention setting greater than 0? |
| 21 | +- Does your stream meet the [KVS video playback track requirements](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html)? |
| 22 | +- If there are fragment decoding errors: |
| 23 | + - Are fragment timestamps accurate, in the correct order, and have no duplicates? ([ListFragments](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html) can be used to retrieve fragment information for a stream) |
| 24 | + - Is your application encoding the frame data using the H.264 format? |
| 25 | + - Does the resolution of the frames match the resolution specified in the Codec Private Data? |
| 26 | + - Does the H.264 profile and level of the encoded frames match the profile and level specified in the Codec Private Data? |
| 27 | + - Does the browser/OS support the profile/level combination? |
| 28 | +- If there are HLS playback failures: |
| 29 | + - Is the fragment duration less than 1 second? If yes, does issue persist with fragments longer than 1 second? |
| 30 | + - Is each HLS streaming session URL being used by only one player at a time? |
| 31 | + - Does each fragment have a consistent number of tracks, is not changing between having both an audio and video track and only a video track, and has consistent encoder settings (resolution and frame rate not changing between fragments in each track)? |
| 32 | + - Does issue persist after fetching using GetHLSStreamingSessionURL with the ContainerFormat and DiscontinuityMode parameters set to different values? |
| 33 | + |
| 34 | + |
| 35 | +### Logging |
| 36 | +Add any relevant SDK and player logs. IMPORTANT NOTE: Please make sure to NOT share AWS access credentials under any circumstance! Please make sure they are not in the logs. |
| 37 | + |
| 38 | +** If you would not like to open an issue to discuss your solution in open-platform, please email your question to [email protected] ** |
0 commit comments