Media extractor
The Media extractor integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] gets a stream URL and sends it to a media player entity. This integration can extract entity specific streams if configured accordingly.
Media extractor doesn’t transcode streams, it just tries to find a stream that matches the requested query.
配置
要将 Media extractor integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：
如果上述 My 按钮不起作用，您也可以手动执行以下步骤：
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角，选择
Add Integration 按钮。 -
从列表中选择 Media extractor。
-
按照屏幕上的说明完成设置。
Play media actions
Navigate to the Actions tab inside Developer Tools. From the Actions dropdown menu select media_extractor.play_media and then press the “Fill Example Data” button at the bottom of the page. Use the “Entity ID” dropdown to select your media player and then press the Perform action button.
This will download the file from the given URL.
| Data attribute | Optional | Description |
|---|---|---|
entity_id |
yes | Name(s) of entities to seek media on, e.g., media_player.living_room_chromecast. Defaults to all. |
media_content_id |
no | The ID of the content to play. Platform dependent. |
media_content_type |
no | The type of the content to play. Must be one of MUSIC, TVSHOW, VIDEO, EPISODE, CHANNEL or PLAYLIST MUSIC. |
Extract media URL action
There is also an action that will directly return the URL in the response of the action.
| Data attribute | Optional | Description |
|---|---|---|
url |
no | The URL of the media to extract. |
format_query |
yes | The query that will be used to select the right media. |
Format query
The query can be used to select the right media. Query examples with explanations:
- bestvideo: Best video-only stream
- best: Best video + audio stream
- bestaudio[ext=m4a]: Best audio stream in M4A format
- worst: Worst video + audio stream
- bestaudio[ext=m4a]/bestaudio[ext=ogg]/bestaudio: Best M4A audio, otherwise best OGG audio and only then any best audio
More info about queries can be found here
Cookies
Some supported video services provide a better experience when you are logged in. For example, if you use Twitch Turbo or are subscribed to a Twitch streamer, logging in prevents the video stream from showing an “An ad is currently playing. Come back after the break.” message until the ad is over. Other examples are private or purchased YouTube videos which you can only watch while logged in. You can add a Netscape format cookie file in the Home Assistant configuration directory. The cookie file will be loaded each time a stream is loaded:
config/media_extractor/cookies.txt
To generate the cookie file, you can use a browser extension (like Get Cookies.txt LOCALLY