Difference between revisions of "Developer:Davaar:ReceiverService"

From LinnDocs
Jump to: navigation, search
(Architectural Overview)
(Actions)
Line 4: Line 4:
  
 
= Actions =
 
= Actions =
== Attributes ==
+
== Sender ==
Reports a space separated list of attributes that identify additional functionality that can be found on the same device as this Sender.
+
Report the Uri and Metadata of the current sender.
  
Currently defined attributes are:
+
==SetSender==
 +
Set the Uri and Metadata of the current sender.
  
* Info - this device reports on the current media using the Info service
+
The Metadata must have originated from a device bearing the [[Developer:Davaar:SenderService|Sender service]].
* Time - this device reports on the current media using the Time service
 
  
== Audio ==
+
The Uri must be the result of applying this receiver's ProtocolInfo to this Metadata.
Reports whether audio is currently present on this sender.
 
  
== Metadata ==
+
==ProtocolInfo==
Provides a representation of this audio item in DIDL-Lite format.
+
Report the receiver's protocol info.
  
== PresentationUrl ==
+
==TransportState==
Reports the Url of a presentation page for further information concerning the sender, or for controlling the sender in some application secific way.
 
  
If this sender has no presentation page, the PresentationUrl should be empty.
+
Report the current transport state, which can be: 'Playing', 'Paused', 'Stopped', or 'Buffering'.
  
== Status ==
+
==Play==
Reports the status of the sender (normally only for debugging purposes):
+
Play the current sender
  
* Sending - currently sending out audio
+
==Stop==
* Ready - ready to send audio but no listeners
+
Stop playing the current sender
* Blocked - audio from another sender detected on the same channel
 
* Inactive - currently no audio to send on this channel
 
* Disabled - sender disabled by user configuration
 
  
 
= Technical Details =
 
= Technical Details =

Revision as of 14:58, 24 November 2010

Architectural Overview

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.

Actions

Sender

Report the Uri and Metadata of the current sender.

SetSender

Set the Uri and Metadata of the current sender.

The Metadata must have originated from a device bearing the Sender service.

The Uri must be the result of applying this receiver's ProtocolInfo to this Metadata.

ProtocolInfo

Report the receiver's protocol info.

TransportState

Report the current transport state, which can be: 'Playing', 'Paused', 'Stopped', or 'Buffering'.

Play

Play the current sender

Stop

Stop playing the current sender

Technical Details

   Domain  : av.openhome.org
   Name    : Sender
   Version : 1

Sender Service Description (XML)