aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJan-Simon Moeller <jsmoeller@linuxfoundation.org>2018-01-16 11:49:45 +0000
committerGerrit Code Review <gerrit@automotivelinux.org>2018-01-16 11:49:45 +0000
commit1f8bc6cca7ca402e2359627d880be3df67bc28cb (patch)
tree241adde09286aea54dcb0ea5fe34f517557d22e6
parent46340988885a128d03930b233ae792bb559f3392 (diff)
parent1e0ded400565dadfb62487258c25a0ea62b409de (diff)
Merge "binding: mediascanner: add binding documentation"
-rw-r--r--README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..05b6cb2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# MediaScanner Service
+
+## Overview
+
+MediaScanner service use the database from respective *lightmediascanner* media scan, and also
+triggers playlist updates when storage media changes.
+
+## Verbs
+
+| Name | Description | JSON Parameters |
+|:---------------|:---------------------------|:---------------------------------------|
+| subscribe | subscribe to media events | *Request:* {"value":"media_added"} |
+| unsubscribe | unsubcribe to media events | *Request:* {"value":"media_added"} |
+| media_result | get current media playlist | See **media_result Reporting** section |
+
+### media_result Reporting
+
+JSON response for *media_result* request parameters is an array of dictionary entries
+with the following fields.
+
+| Name | Description |
+|:------------|---------------------------------------------|
+| duration | length of track in milliseconds |
+| path | path to media on filesystem |
+| title | title for media entey |
+| album | album name for media entry |
+| artist | artist name for media entry |
+| genre | genre type for media entry |
+| type | media entry data type *(e.g audio, video)* |
+
+## Events
+
+| Name | Description |
+|:---------------|:---------------------------------------------------|
+| media_added | event that reports storage media insertion |
+| media_removed | event that reports storage media removal |
+
+### media_added Event JSON Response
+
+JSON response for this event has the same results as documented in **media_result Reporting ** sections.
+
+### media_removed Event JSON Response
+
+JSON response has a single field **Path** that is the location of media that has been removed.