Update stream technical details (#23407)

* Update stream technical details

* Include more H.265 information

* Remove outdated ffmpeg information
This commit is contained in:
uvjustin 2022-07-21 18:07:10 +08:00 committed by GitHub
parent c0ff5aeb0c
commit 5889ae25be
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -59,21 +59,5 @@ stream:
## Technical Details
The integration currently supports proxying H.264 and H.265 source streams to the HLS protocol and requires at least FFmpeg >= 4. Note that H.265 support is limited to Safari, iOS, and Android. The `stream` integration also provides limited support for audio. PCM codecs (e.g. G.711/G.723/G.726/G.729) are not supported. ADTS AAC audio is also currently not supported. Most other AAC and MP3 encoded audio should work.
## Troubleshooting
Users on manual installs with FFmpeg < 4 may see an error similar to:
```text
2020-04-28 13:35:43 ERROR (SyncWorker_5) [homeassistant.util.package] Unable to install package av==7.0.1: ERROR: Command errored out with exit status 1:
command: /mnt/c/dev/home-assistant/venv/bin/python3.7 -u -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-install-twd7glz2/av/setup.py'"'"'; __file__='"'"'/tmp/pip-install-twd7glz2/av/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' install --record /tmp/pip-record-x9tw2ql2/install-record.txt --single-version-externally-managed --compile --install-headers /mnt/c/dev/home-assistant/venv/include/site/python3.7/av
cwd: /tmp/pip-install-twd7glz2/av/
```
You can solve this by running the following steps to update FFmpeg >= 4:
```text
sudo add-apt-repository ppa:jonathonf/ffmpeg-4
sudo apt upgrade
```
The integration currently supports proxying H.264 and H.265 source streams to the HLS (and LL-HLS) protocol. Note that while H.265 works on Android and iOS, it does not work in many browsers. This is a browser limitation and not a Home Assistant issue. Safari has native H.265 support, and H.265 also works in Edge on Windows when "HEVC Video Extensions" is installed. Chrome versions >= 104 may also work when started with the "--enable-features=PlatformHEVCDecoderSupport" option. For testing HEVC browser support, do not rely on the https://www.caniuse.com charts or the https://html5test.com site. They are wrong. You can instead use the ["Unprefixed tests" from caniuse.com](https://tests.caniuse.com/?feat=hevc) or the [hls.js demo app with an HEVC HLS stream](https://hls-js.netlify.app/demo/?src=https%3A%2F%2Fbitmovin-a.akamaihd.net%2Fcontent%2Fdataset%2Fmulti-codec%2Fhevc%2Fstream_fmp4.m3u8). The videos there should play if your browser supports H.265.
The `stream` integration supports AAC and MP3 audio. PCM codecs (e.g. G.711/G.723/G.726/G.729) are not supported.