[Property] Support of DLNA.ORG_CI, DLNA.ORG_FLAGS and DLNA.ORG_OP

Fix https://github.com/01org/dleyna-server/issues/54

Add 3 new properties to Resource.
As for other Resources properties, they are also directly
available in MediaTiem2 or MediaContainer2 item by using the
algorithm for selecting resource, given in the section
"Transcoding and org.gnome.UPnP.MediaItem2".

Signed-off-by: Ludovic Ferrandis <ludovic.ferrandis@intel.com>

1 files changed, 41 insertions, 11 deletions

diff --git a/doc/server/dbus/API.txt b/doc/server/dbus/API.txt
index b04fcde..d040396 100644
--- a/doc/server/dbus/API.txt
+++ b/doc/server/dbus/API.txt
@@ -568,9 +568,12 @@ Additional properties unsupported by org.gnome.MediaContainer2
 | Resources              |aa{sv}|  o   |  Returns the set of resources      |
 |                        |      |      |  associated with a container       |
 |---------------------------------------------------------------------------|
-| DLNAProfile            |  s   |  o   |                                    |
-| MIMEType               |  s   |  o   |  See "Container properties"        |
-| Size                   |  x   |  o   |  paragraph below.                  |
+| DLNAConversion         | a{sb}|  o   |                                    |
+| DLNAFlags              | a{sb}|  o   |                                    |
+| DLNAOperation          | a{sb}|  o   |  See "Container properties"        |
+| DLNAProfile            |  s   |  o   |  paragraph below.                  |
+| MIMEType               |  s   |  o   |                                    |
+| Size                   |  x   |  o   |                                    |
 | UpdateCount            |  u   |  o   |                                    |
 | URLs                   |  as  |  o   |                                    |
 |---------------------------------------------------------------------------|
@@ -585,6 +588,8 @@ support different playlist formats, e.g., M3U, DIDL-S, etc. The
 properties of one of these resources may be duplicated directly in the
 Container object itself. The algorithm for selecting this resource
 is given in the section "Transcoding and org.gnome.UPnP.MediaItem2".
+In MediaItem2 section also, you will find the definition for these properties
+in Resources/Additional properties.
 
 New Methods:
 ------------
@@ -830,20 +835,42 @@ in the table below:
 The names of the properties included in this array are identical to
 the names of the org.gnome.UPnP.MediaItem2 properties to which they
 correspond, e.g., MIMEType, Size.
-However, one additional property is included.
+However, four additional properties are included.
 
-Additional property
--------------------
+Additional properties:
+----------------------
 
 |---------------------------------------------------------------------------|
-|     Name        | Type | m/o* |              Description                  |
+|     Name        | Type  | m/o* |              Description                 |
+|---------------------------------------------------------------------------|
+| DLNAConversion  | a{sb} |  o   |  Indicates whether the content of the    |
+|                 |       |      |  Resource is in original source format   |
+|                 |       |      |  or if the content is transcoded.        |
+|                 |       |      |  There are 1 key: Transcoded.            |
+|                 |       |      |  See Reference (4): DLNA.ORG_CI.         |
+|---------------------------------------------------------------------------|
+| DLNAFlags       | a{sb} |  o   |  A dictionary of boolean values          |
+|                 |       |      |  indicating the values of the various    |
+|                 |       |      |  operations supported by a resource.     |
+|                 |       |      |  There are 12 keys:                      |
+|                 |       |      |  SenderPaced, TimeBased, ByteBased,      |
+|                 |       |      |  PlayContainer, S0Increase, SNIncrease   |
+|                 |       |      |  RTSPPause, StreamingTM, InteractiveTM   |
+|                 |       |      |  BackgroundTM, ConnectionStall, DLNA_V15 |
+|                 |       |      |  See Reference (5): DLNA.ORG_FLAGS.      |
+|---------------------------------------------------------------------------|
+| DLNAOperation   | a{sb} |  o   |  A dictionary of boolean values          |
+|                 |       |      |  indicating the values of the various    |
+|                 |       |      |  DLNA Operation attributes. There are 2  |
+|                 |       |      |  keys: RangeSeek and TimeSeek.           |
+|                 |       |      |  See Reference (6): DLNA.ORG_OP.         |
 |---------------------------------------------------------------------------|
-| UpdateCount     |  u   |  o   |  Contains the number of times the         |
-|                 |      |      |  implementation detects that a change was |
-|                 |      |      |  made to the resource.                    |
+| UpdateCount     |  u    |  o   |  Contains the number of times the        |
+|                 |       |      |  implementation detects that a change    |
+|                 |       |      |  was made to the resource.               |
 |---------------------------------------------------------------------------|
 
-Please note that if you want this property to be included in the
+Please note that if you want these properties to be included in the
 results of a call to one of the List or the Search functions, and you
 are explicitly filtering properties, you must include "Resource" in
 the filter array.  The filter parameter also applies to the contents
@@ -935,3 +962,6 @@ References:
 2) DLNA Guidelines December 2011, Part 1 Architectures and Protocols
 (http://www.dlna.org/)
 3) MediaServer2Spec (http://live.gnome.org/Rygel/MediaServer2Spec)
+4) See 2) 7.4.1.3.22 MM ci-param (Conversion Indicator Flag)
+5) See 2) 7.4.1.3.23 MM flags-param (Flags Parameter)
+6) See 2) 7.4.1.3.19 MM op-param (Operations Parameter for HTTP)