aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatt Ranostay <matt.ranostay@konsulko.com>2018-01-11 11:37:44 -0800
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2018-01-16 11:49:38 +0000
commita9a6f1c0d3a39a12709ab19bb4d2c77400fea10d (patch)
tree37a7ac36226bcbbdf8783f5841cd9ca582ccdcf2
parent4a2b9a16d6fc2459fa0ab3daa8cf7064e4616a81 (diff)
binding: mediascanner: add binding documentation
Add initial documentation for agl-service-mediascanner service Bug-AGL: SPEC-1245 Change-Id: I04130aacf1a2ad50d0c3e57a1ace5b1750f3c163 Signed-off-by: Matt Ranostay <matt.ranostay@konsulko.com>
-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.