117
edits
Changes
→Brief description
== Brief description ==Playlist API allows to export playlist in different formats from Ace Stream Media Server. API endpoint: <tt>'''<tt><nowiki>http://<engine_host>:6878/playlist/get</nowiki>'''</tt>'''
'''Parameters:'''
Boolean values are passed as 0 or 1 (e.g. transcode_audio=1)List , list of integers is passed as string of values concatenated with comma (e.g. items=14,115,127).
Allowed values for list parameters:
== Playlist output formats ==
"'''m3u'''" format is intented for different media players.
At the moment we use M3U format with some additional fields, specific to Ace Stream.
Each playlist item is identified either by Content ID (start with acestream://) or infohash (starts with magnet:). Infohash is used when Content ID is not available for some playlist item.
Both types of identifiers are recognized by Ace Stream Media Server when playlist is imported.
"'''json'''" format is indented to be used for automation. Playlist is returned as list of items, each item is an object with such fields: - * ''id '' (integer) - playlist item id unique for this media server; this id can be passed in "items" parameter to filter specific playlist items; - * ''title '' (string) - title; - * ''playback_url '' (string) - playback URL; - * ''content_id '' (string) - Content ID (may be null); - * ''infohash '' (string) - infohash (may be null); - * ''transport_file_url '' (string) - transport file URL (may be null); - * ''category '' (string) - media type (see list for "category" parameter); - * ''is_live '' (integer) - 1: live content, 0: VOD, -1: unknown; - * ''auto_search '' (bool) - whether autosearch is enabled for this playlist item; - * ''tags '' (list of strings) - list of tags.
== Examples ==
'''Get playlist in "m3u" format:'''
Request:
<nowiki>http://127.0.0.1:6878/playlist/get?format=acestreamm3u</nowiki>
Response:
#EXTM3U
#EXTINF:-1,Test Channel 1
#EXTINF:-1 acestream-autosearch="1",Test Channel 2
'''Get playlist in "acestream" format:'''
Request:
<nowiki>http://127.0.0.1:6878/playlist/get?format=m3uacestream</nowiki>
Response:
#EXTM3U
#EXTINF:-1,Test Channel 1
#EXTINF:-1 acestream-autosearch="1",Test Channel 2
Request:
<nowiki>http://127.0.0.1:6878/playlist/get?format=json</nowiki>
Response:
"auto_search": false,
"title": "Test Channel 1",
"playback_url": "<nowiki>http://127.0.0.1:6878/ace/getstream?id=acbfd1954084ffc68c65b0948485e5d0f82173e2&hlc=1&transcode_audio=0 &transcode_mp3=0&transcode_ac3=0&preferred_audio_language=eng</nowiki>",
"is_live": 1,
"transport_file_url": null,
"auto_search": true,
"title": "Test Channel 2",
"playback_url": "<nowiki>http://127.0.0.1:6878/ace/getstream?infohash=7889e5f0cea9b72f5dcd7a9c67e665c7f4f5b3eb&hlc=1&transcode_audio=0 &transcode_mp3=0&transcode_ac3=0&preferred_audio_language=eng</nowiki>",
"is_live": 1,
"transport_file_url": null,