From OpenHome

Jump to: navigation, search

Contents

Receiver Service

Overview

A Songcast receiver plays audio broadcast from a 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. If the Receiver service is available, all its properties and actions must be fully implemented.

Evented Properties

Metadata

The metadata of the sender to listen to. In the OpenHome Metadata format provided by the Sender service.

Uri

The uri of the Sender to listen to.

Actions

Sender

Arguments: (out string uri, out string metadata)
Report the values of the Uri and Metadata properties.

UPnP Service Description

For devices supporting the UPnP protocol, the service description is

name: "Receiver"
domain: "openhome.org.eriskay"
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>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>
  </actionList>
  <serviceStateTable>
    <stateVariable sendEvents="yes">
      <name>Uri</name>
      <dataType>string</dataType>
    </stateVariable>
    <stateVariable sendEvents="yes">
      <name>Metadata</name>
      <dataType>string</dataType>
    </stateVariable>
  </serviceStateTable>
</scpd>