react-native-video/docs/pages/other/debug.md

# Debugging

## HTTP playback doesn't work or  Black Screen on Release build (Android)
If your video work on Debug mode, but on Release you see only black screen, please, check the link to your video. If you use 'http' protocol there, you will need to add next string to your AndroidManifest.xml file. [Details here](https://developer.android.com/guide/topics/manifest/application-element#usesCleartextTraffic)

```xml
<application
 ...
 android:usesCleartextTraffic="true"
>
```

## Decoder Issue (Android)

Devices have a maximum of simultaneous possible playback. It means you have reach this limit. Exoplayer returns: 'Unable to instantiate decoder'

**known issue**: This issue happen really often in debug mode.

## You cannot play clean content (all OS)

Here are the steps to consider before opening a ticket in issue tracker

## Check you can access to remote file

Ensure you can download to manifest / content file with a browser for example

## Check another player can read the content

Usually clear playback can be read with all Video player. Then you should ensure content can be played without any issue with another player ([VideoLan/VLC](https://www.videolan.org/vlc/) is a good reference implementation)

## You cannot play protected content (all OS)

## Protected content gives error (token error / access forbidden) 

If content is protected with an access token or any other http header, ensure you can access to you data with a wget call or a rest client app. You need to provide all needed access token / authentication parameters.

## Everything seems correct but content cannot be accessed

You need to record network trace to ensure communications with server is correct.
[Charles proxy](https://www.charlesproxy.com/) is a simple and useful tool to sniff all http/https calls. 
With this tool you should be able to analyze what is going on with network. You will see all access to content and DRM, audio / video chunks, ...

Then try to compare exchanges with previous tests you made.

## It's still not working

You can try to open a ticket now !
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`# Debugging`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## HTTP playback doesn't work or Black Screen on Release build (Android)`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00			`If your video work on Debug mode, but on Release you see only black screen, please, check the link to your video. If you use 'http' protocol there, you will need to add next string to your AndroidManifest.xml file. [Details here](https://developer.android.com/guide/topics/manifest/application-element#usesCleartextTraffic)`

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			```xml
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00			`<application`
			`...`
			`android:usesCleartextTraffic="true"`
			`>`
			```

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## Decoder Issue (Android)`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`Devices have a maximum of simultaneous possible playback. It means you have reach this limit. Exoplayer returns: 'Unable to instantiate decoder'`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`known issue: This issue happen really often in debug mode.`

			`## You cannot play clean content (all OS)`

			`Here are the steps to consider before opening a ticket in issue tracker`

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## Check you can access to remote file`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`Ensure you can download to manifest / content file with a browser for example`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## Check another player can read the content`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`Usually clear playback can be read with all Video player. Then you should ensure content can be played without any issue with another player ([VideoLan/VLC](https://www.videolan.org/vlc/) is a good reference implementation)`

			`## You cannot play protected content (all OS)`

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## Protected content gives error (token error / access forbidden)`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`If content is protected with an access token or any other http header, ensure you can access to you data with a wget call or a rest client app. You need to provide all needed access token / authentication parameters.`

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## Everything seems correct but content cannot be accessed`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`You need to record network trace to ensure communications with server is correct.`
feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`[Charles proxy](https://www.charlesproxy.com/) is a simple and useful tool to sniff all http/https calls.`
			`With this tool you should be able to analyze what is going on with network. You will see all access to content and DRM, audio / video chunks, ...`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`Then try to compare exchanges with previous tests you made.`

feat: move docs to github pages (#3296) * feat(docs): setup nextra * feat(docs): add pages * docs: update introduction page * docs: fix typos * docs: fix links * docs: update README * docs: sync with master * docs: remove old docs * fix(ci/docs): fix typos * fix(ci/docs): fix docs setup * fix(docs): update next config * chore(ci/docs): clean up * chore(docs): add meta tags * chore: apply review changes * docs: move drm into api section * docs: fix next config * docs: fix links * docs: add methods section * chore: sync with main * docs: add missing onAudio events 2023-10-26 00:54:14 -06:00			`## It's still not working`
doc: add link to side project and create a debugging page 2022-09-14 15:55:14 -06:00
			`You can try to open a ticket now !`