diff options
| author |   Jan-Simon Moeller <jsmoeller@linuxfoundation.org> | 2018-01-16 11:49:45 +0000 |
|---|---|---|
| committer |   Gerrit Code Review <gerrit@automotivelinux.org> | 2018-01-16 11:49:45 +0000 |
| commit | 1f8bc6cca7ca402e2359627d880be3df67bc28cb (patch) | |
| tree | 241adde09286aea54dcb0ea5fe34f517557d22e6 | |
| parent | 46340988885a128d03930b233ae792bb559f3392 (diff) | |
| parent | 1e0ded400565dadfb62487258c25a0ea62b409de (diff) | |
Merge "binding: mediascanner: add binding documentation"
| -rw-r--r-- | README.md | 44 |
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. |