Skip to content

Commit

Permalink
Create playback-issue.md
Browse files Browse the repository at this point in the history
  • Loading branch information
stefankiesz authored Apr 8, 2024
1 parent ca558f7 commit 19c3f77
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions .github/ISSUE_TEMPLATE/playback-issue.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
name: HLS/DASH/Console Playback Failure
about: Are you experiencing a failure when playing your streamed media?
title: "[Playback Failure]"
labels: Playback
assignees: ''

---

**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.

### Brief 1-liner description of the issue:
...

### Please include the following details:
- Problematic playback methods (HLS, DASH, and/or AWS Console), operating systems, browsers:
- ...
- Working playback methods (were you able to playback the stream using using any methods?), operating systems, browsers:
- ...
- Is the stream's data retention setting greater than 0?
- Does your stream meet the [KVS video playback track requirements](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html)?
- If there are fragment decoding errors:
- 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) - Is your application encoding the frame data using the H.264 format?
- Does the resolution of the frames match the resolution specified in the Codec Private Data?
- Does the H.264 profile and level of the encoded frames match the profile and level specified in the Codec Private Data?
- Does the browser/OS support the profile/level combination?
- If there are HLS playback failures:
- Is the fragment duration less than 1 second? If yes, does issue persist with fragments longer that 1 second?
- Is each HLS streaming session URL being used by only one player at a time?
- 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)?
- Does issue persist after fetching using GetHLSStreamingSessionURL with the ContainerFormat and DiscontinuityMode parameters set to different values?


### Logging
Add any relevent 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.

** If you would not like to open an issue to discuss your solution in open-platform, please email your question to [email protected] **

0 comments on commit 19c3f77

Please sign in to comment.