From OpenHome
(→Product Service Description (XML)) |
|||
| Line 30: | Line 30: | ||
Report the value of the <tt>TransportState</tt> state variable. | Report the value of the <tt>TransportState</tt> state variable. | ||
| - | = | + | = Receiver Service Description (XML) = |
<code> | <code> | ||
Domain : av.openhome.org | Domain : av.openhome.org | ||
Revision as of 11:06, 5 November 2013
Contents |
Overview
A Songcast receiver plays audio broadcast from a Songcast sender.
The Receiver service provides the means for controlling a Receiver source. If a device's Product service reports a source of type Receiver, then that device is guaranteed to bear the Receiver service.
State Variables
Metadata
The metadata of the sender to listen to. In the DIDL-lite format provided by the Sender service.
Uri
The uri of the Sender to listen to. This must match the uri from the sender’s metadata.
ProtocolInfo
Reports the protocols supported in the normal UPnP forum format – a comma separated list of elements of the form
<protocol>: <network>:<contentFormat>:<additionalInfo>
Supported protocol elements are <ohz>, <ohm> and <ohu>. Other elements are normally wildcards *
TransportState
Report the current transport state, which can be: Playing, Waiting, Stopped or Buffering.
Note that network conditions may prevent a Receiver from accurately differentiating between Waiting and Buffering states.
Actions
Play
Play audio from the current sender.
Stop
Stop playing audio from the current sender.
SetSender
Set the uri and metadata of the sender to listen to.
Sender
Report the values of the Uri and Metadata state variables.
ProtocolInfo
Report the value of the ProtocolInfo state variable.
TransportState
Report the value of the TransportState state variable.
Receiver Service Description (XML)
Domain : av.openhome.org Name : Receiver Version : 1
<?xml version="1.0"?> <scpd xmlns="urn:schemas-upnp-org:service-1-0"> <specVersion> <major>1</major> <minor>0</minor> </specVersion> <actionList> <action> <name>Play</name> </action> <action> <name>Stop</name> </action> <action> <name>SetSender</name> <argumentList> <argument> <name>Uri</name> <direction>in</direction> <relatedStateVariable>Uri</relatedStateVariable> </argument> <argument> <name>Metadata</name> <direction>in</direction> <relatedStateVariable>Metadata</relatedStateVariable> </argument> </argumentList> </action> <action> <name>Sender</name> <argumentList> <argument> <name>Uri</name> <direction>out</direction> <relatedStateVariable>Uri</relatedStateVariable> </argument> <argument> <name>Metadata</name> <direction>out</direction> <relatedStateVariable>Metadata</relatedStateVariable> </argument> </argumentList> </action> <action> <name>ProtocolInfo</name> <argumentList> <argument> <name>Value</name> <direction>out</direction> <relatedStateVariable>ProtocolInfo</relatedStateVariable> </argument> </argumentList> </action> <action> <name>TransportState</name> <argumentList> <argument> <name>Value</name> <direction>out</direction> <relatedStateVariable>TransportState</relatedStateVariable> </argument> </argumentList> </action> </actionList> <serviceStateTable> <stateVariable sendEvents="yes"> <name>Uri</name> <dataType>string</dataType> </stateVariable> <stateVariable sendEvents="yes"> <name>Metadata</name> <dataType>string</dataType> </stateVariable> <stateVariable sendEvents="yes"> <name>TransportState</name> <dataType>string</dataType> <allowedValueList> <allowedValue>Stopped</allowedValue> <allowedValue>Playing</allowedValue> <allowedValue>Waiting</allowedValue> <allowedValue>Buffering</allowedValue> </allowedValueList> </stateVariable> <stateVariable sendEvents="yes"> <name>ProtocolInfo</name> <dataType>string</dataType> </stateVariable> </serviceStateTable> </scpd>