117
edits
Changes
→API methods
==About==
Since version 3.1 we implemented API to control app engine via HTTP. To do that, you should send appropriate HTTP GET query to the app engine (default IP:port is 127.0.0.1:6878)
==Limitations==
</body>
</html></nowiki>
==Using HTTP API on Android==
HTTP API is a preferred way to integrate engine with other applications on Android.
Before sending any requests to engine you should ensure that it is running. This should be done by binding to engine service as described
[[Using_Ace_Stream_as_service_on_Android|here]].
==API methods==
Terms: <tt>''<engine_address>''</tt> - app engine IP address, <tt>''<engine_port>''</tt> - app engine HTTP port.
Common params:
*'''id''' - content id (conditional param)
*'''infohash''' - transport file infohash (.acelive or .torrent file) (conditional param)
*'''url''' - link to transport file (conditional param). Can be used with URL encoded "file://path/" to access local file.*'''pathpid''' - local path to transport file [[#Player ID|player id]] (conditional paramoptional, formerly known as '''sid''', since ver. 3.1.29 is obsolete and replaced by '''pid''')
In the query to the app engine at least one of params <tt>id</tt>, <tt>infohash</tt>, <tt>url</tt>, <tt>path</tt> must be present.
===How to get HLS stream===
==Player ID==
Player ID ('''pid''') - random string, used for impersonate player identification during engine connect session.
"Player ID " purpose - app engine should must distinguish one player session from another, as in the current engine implementation user cannot play the same live-stream with two (or more) players simultaneously from one engine, and engine will stop to serve requests from one player, when got a new request from another.
