Gottfried Zimmermann URC Consortium Copyright 2007-2008, Access Technologies Group. This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/us/. http://myurc.org/iso24752-2/2007 2008-09-29 Note: The socket description contains data relevant for the user interface only. Other data may be stored internally such as connection manager specific instanceIDs, etc. Each instance of this set (i.e. set of subelements) represents an available media server. From each server, the user can pick the digital media to play (reflected by the variable "selectedBrowseId"). There are two methods for the user to select content: browsing or searching. false() Friendly name of media server. This is typically a user-configured string, such as "NAS in kitchen". Friendly name from device description. true() false() true() false() Indicates that this is the currently selected media server to be used for establishing a connection. Note that only one media server can be selected at a time, i.e. another media server will be automatically deselected. true() true() CSV list of available connection protocols (in ProtocolInfo coding) that can be used for playing content from the selected Media Server (source) . Comes with resources, such as labels (human-readable description of connection such as "JPEG over HTTP"). false() false() Search capabilities of the currently selected media server. SearchCapabilities is a CSV list of property names that can be used in search queries. An empty string indicates that the CDS does not support any kind of searching. A wildcard ('*') indicates that the device supports search queries using all tags present in the CDS. Note 1: The "smart" URC may use this variable to tweak its user interface for searching. Note 2: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. Maps to return value of UPnP action GetSearchCapabilities. Should be called at initialization and every time the user changes the selected media server. false() false() Sort capabilities of the currently selected media server. SortCapabilities is a CSV list of tags that the CDS can use to sort Search() or Browse() results. An empty string indicates that the device does not support any kind of sorting. A wildcard ('*') indicates that the device supports sorting using all tags present in the Content Directory. Note: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. Maps to return value of UPnP action GetSortCapabilities. Should be called at initialization and every time the user changes the selected media server. false() false() This command allows the invoker to browse the content directory. Action Browse in CDS. browseFilter determines the set of properties of digital media items presented in variable "content". Comma-separated list of property specifiers (including namespaces); indicates which metadata properties are to be returned in the results from browsing. Both properties represented in CDS query results as XML elements, as well as properties represented as element attributes, may be included in the comma-separated list. If the Filter parameter is equal to "*", all properties are returned. As a rule, all required properties are returned, but no optional properties will be returned unless explicitly requested in the filter. Note: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. Maps to the parameter Filter of action Browse. If browseFilter is changed by the user, variable "content" needs to get updated. browseSortCriteria determines how the digital media items are sorted in variable "content". Comma-separated list of signed property names, where signed means preceded by '+' or '-' sign. The '+' and '-' indicate the sort is in ascending or descending order, respectively, with regard to the value of its associated property. Properties appear in the list in order of descending sort priority. For example, a value of "+upnp:artist,-dc:date,+dc:title" would sort first on artist in ascending order, then within each artist by date in descending order (most recent first) and finally by title in ascending order. Note 1: Possible values of browseSortCriteria are constrained by sortCapabilities. Note 2: A "knowledgeable URC" could provide a custom-made user interface with lists and checkboxes to fill this variable, and based on the possibilities of sorting described in sortCapabilities. Note 3: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. Maps to the parameter SortCriteria of action Browse. If browseSortCriteria is changed by the user, variable "content" needs to get updated. The result of the browse operation is reflected in the socket elements of the set "browseContent". Id of the node from content that is currently selected for playing. This node is in focus for a play operation. Serves as parameter for a play operation. false() Is Next Node available or not? false() false() Is Previous Node available or not? false() false() Is Parent Node available or not? false() false() Is First Child Node available or not? false() false() true() true() true() true() true() true() true() true() Name of the currently selected node. false() false() Index of currently selected node in the list of its siblings. false() false() Total number of tracks in the present container being browsed. false() false() id property of object's parent. The parentID of the Content Directory 'root' container must be set to the reserved value of "-1". No other parentID attribute of any other Content Directory object may take this value. false() false() Child count for the object. Applies to containers only. false() false() Type of the currently selected node: folder or item. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. When true, the ability to perform a Search() action under a container is enabled, otherwise a Search() under that container will return no results. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. false() false() When true, ability to modify a given object is confined to the Content Directory Service. Control point metadata write access is disabled. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. false() false() When present, controls the modifiability of the resources of a given object. Ability of a Control Point to change writeStatus of a given resource(s) is implementation dependent. Allowed values are: WRITABLE, PROTECTED, NOT_WRITABLE, UNKNOWN, MIXED. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. false() true() Resource, typically a media file, associated with the object. Values must be properly escaped URIs as described in [RFC 2396]. Space-separated list of didl-lite:res element values of selected node. Optional for nodes of any class. false() false() Create class of the associated container object. If restricted = false, then * If no createClass elements are specified, then CreateObject can create any class of object under the container * If createClass elements are specified then, CreateObject can only create classes of objects specified in the createClass tags * createClass is optional * createClass semantics are per container, there is no parent-child relationship, they only apply to CreateObject actions in that container false() value('class')=='object.container' and not(value('restricted')) and value('writeStatus'))!='NOT_WRITABLE' and value('writeStatus'))!='PROTECTED') id property of the item being referred to. false() false() Set of human-readable metadata information pertaining to the currently selected node (container or item). Each metadata item can be modified by the user; which will immediately impact the Note: At least one modification can be reversed by the undo command. true() not(value('restricted')) and value('writeStatus'))!='NOT_WRITABLE' and value('writeStatus'))!='PROTECTED') This command allows the invoker to search the content directory for objects that match some search criteria. The search criteria are specified as a query string operating on properties with comparison and logical operators. Note 1: The search command is independent from browsing, and has its own result "variable" as an output parameter. However, a client may show the results of the search in the content tree if it wishes so. Note 2: It should be possible for a client to provide an incremental search function based on the user's partial input, by invoking the search command multiple times (incrementally). Action Search in CDS. Parameters: ContainerID=searchContainerId; SearchCriteria=searchCriteria; Filter=searchFilter; SortCriteria=searchSortCriteria; StartingIndex and RequestedCount implicit. Result is presented as output parameter "searchResult". Unique identifier of the container in which to begin searching. A ContainerID value of zero corresponds to the root object of the Content Directory. Note: Searchable must be true for the container. Search string for expert users. The SearchCriteria parameter gives one or more search criteria to be used for querying the Content Directory. For syntax details refer to CD 1.0 spec, 2.5.5.1. SearchCriteria String Syntax. Note 1: Possible values are constrained by searchCapabilities. Note 2: A "smart" URC may generate the searchCriteria string from a more user-friendly set of widgets. Note 3: Since there is no pertinent type definition in the upnp namespace, we are using xsd:string here. Comma-separated list of property specifiers (including namespaces); indicates which metadata properties are to be returned in the results from searching. Both properties represented in CDS query results as XML elements, as well as properties represented as element attributes, may be included in the comma-separated list. If the Filter parameter is equal to "*", all properties are returned. As a rule, all required properties are returned, but no optional properties will be returned unless explicitly requested in the filter. Note 1: A "smart" URC may generate the searchFilter list from a more user-friendly set of widgets. Note 2: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. CSV list of signed property names, where signed means preceded by '+' or '-' sign. The '+' and '-' indicate the sort is in ascending or descending order, respectively, with regard to the value of its associated property. Properties appear in the list in order of descending sort priority. For example, a value of "+upnp:artist,-dc:date,+dc:title" would sort first on artist in ascending order, then within each artist by date in descending order (most recent first) and finally by title in ascending order. Note 1: This value is constrained by sortCapabilities. Note 2: A "smart" URC would present this in a user-friendly way. Note 3: Since there is no pertinent type definition in the upnp namespace, we are using uis:csvlist here. The result of the search is reflected in the socket elements of the set "content". No separate socket elements for the search result are available. Id of the node from search content that is currently selected for playing. This node is in focus for a play operation. Serves as parameter for a play operation. false() Is Next Node available or not? false() false() Is Previous Node available or not? false() false() true() true() true() true() Name of the currently selected node. false() false() Index of currently selected node in the list of its siblings. false() false() Total number of tracks in the present container being browsed. false() false() Type of the currently selected node: folder or item. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. When present, controls the modifiability of the resources of a given object. Ability of a Control Point to change writeStatus of a given resource(s) is implementation dependent. Allowed values are: WRITABLE, PROTECTED, NOT_WRITABLE, UNKNOWN, MIXED. Note: Although this information can be retrieved from xmlContent, this variable is defined for expressing dependencies. false() true() Resource, typically a media file, associated with the object. Values must be properly escaped URIs as described in [RFC 2396]. Space-separated list of didl-lite:res element values of selected node. Optional for nodes of any class. false() false() id property of the item being referred to. false() false() Set of human-readable metadata information pertaining to the currently selected node (container or item). Each metadata item can be modified by the user; which will immediately impact the Note: At least one modification can be reversed by the undo command. true() not(value('restricted')) and value('writeStatus'))!='NOT_WRITABLE' and value('writeStatus'))!='PROTECTED') Each instance of this set (i.e. set of subelements) represents an available media renderer. For each renderer, the user can set rendering control features with the renderer being connected or not connected. false() Friendly name of media renderer. This is typically a user-configured string, such as "living room TV". Friendly name from device description. true() false() true() false() Indicates that this is the currently selected media renderer to be used for establishing a connection. Note that only one media renderer can be selected at a time, i.e. another media renderer will be automatically deselected. true() true() CSV list of available connection protocols (in ProtocolInfo coding) that can be used for playing content from the selected Media Renderer (sink) . Comes with resources, such as labels (human-readable description of connection such as "JPEG over HTTP"). false() false() This set contains elements pertaining to the rendering settings of the media renderer, applying to its post-mix settings (connection-independent). ***** Elements in this set are based on RenderingControl Service ***** Elements of this set bind to the UPnP actions with parameter instanceID=0. Upper value limit for variable volume. For initialization, extract upper limit for state variable Volume from XML Service Description for RenderingControl service of Target device (same for all channels). This set contains pre-defined configuration settings for the selected media renderer. This variable contains a comma-separated list (i.e. CSV(string)) of valid preset names currently supported by this device. presetNameList must include "FactoryDefaults", and may include "InstallationDefaults". Its value changes if/when the device changes the set of presets that it supports. This may occur in conjunction with a vendor-defined action or some other non-UPnP event. This state variable will include any of the predefined presets that are supported by the device. UPnP action ListPresets for getting, and state variable LastChange for updates. true() false() This command restores (a subset) of the state variables to the values associated with the specified preset. The specified preset name may be one of those in presetNameList. The selected preset determines which state variables will be affected. UPnP action SelectPreset for setting. Getter method not available. No updates. This set contains video rendering controls for the selected media renderer. Upper value limit for variable brightness. For initialization, extract upper limit for state variable Brightness from XML Service Description for RenderingControl service of Target device. Upper value limit for variable contrast. For initialization, extract upper limit for state variable Contrast from XML Service Description for RenderingControl service of Target device. Upper value limit for variable sharpness. For initialization, extract upper limit for state variable Sharpness from XML Service Description for RenderingControl service of Target device. Upper value limit for variable redVideoGain. For initialization, extract upper limit for state variable RedVideoGain from XML Service Description for RenderingControl service of Target device. Upper value limit for variable greenVideoGain. For initialization, extract upper limit for state variable GreenVideoGain from XML Service Description for RenderingControl service of Target device. Upper value limit for variable blueVideoGain. For initialization, extract upper limit for state variable BlueVideoGain from XML Service Description for RenderingControl service of Target device. Upper value limit for variable redVideoBlackLevel. For initialization, extract upper limit for state variable RedVideoBlackLevel from XML Service Description for RenderingControl service of Target device. Upper value limit for variable greenVideoBlackLevel. For initialization, extract upper limit for state variable GreenVideoBlackLevel from XML Service Description for RenderingControl service of Target device. Upper value limit for variable blueVideoBlackLevel. For initialization, extract upper limit for state variable BlueVideoBlackLevel from XML Service Description for RenderingControl service of Target device. Upper value limit for variable colorTemperature. For initialization, extract upper limit for state variable ColorTemperature from XML Service Description for RenderingControl service of Target device. Upper value limit for variable horizontalKeystone. For initialization, extract lower limit for state variable HorizontalKeystone from XML Service Description for RenderingControl service of Target device. Upper value limit for variable horizontalKeystone. For initialization, extract upper limit for state variable HorizontalKeystone from XML Service Description for RenderingControl service of Target device. Upper value limit for variable verticalKeystone. For initialization, extract lower limit for state variable VerticalKeystone from XML Service Description for RenderingControl service of Target device. Upper value limit for variable verticalKeystone. For initialization, extract upper limit for state variable VerticalKeystone from XML Service Description for RenderingControl service of Target device. This unsigned integer variable represents the current brightness setting of the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetBrightness for getting, SetBrightness for setting. State variable LastChange for updates. value('brightnessMaxValue') This unsigned integer variable represents the current contrast setting of the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetContrast for getting, SetContrast for setting. State variable LastChange for updates. value('contrastMaxValue') This unsigned integer variable represents the current sharpness setting of the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetSharpness for getting, SetSharpness for setting. State variable LastChange for updates. value('sharpnessMaxValue') This unsigned integer variable represents the current setting of the red "gain" control for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetRedVideoGain for getting, SetRedVideoGain for setting. State variable LastChange for updates. value('redVideoGainMaxValue') This unsigned integer variable represents the current setting of the green "gain" control for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetGreenVideoGain for getting, SetGreenVideoGain for setting. State variable LastChange for updates. value('greenVideoGainMaxValue') This unsigned integer variable represents the current setting of the blue "gain" control for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetBlueVideoGain for getting, SetBlueVideoGain for setting. State variable LastChange for updates. value('blueVideoGainMaxValue') This unsigned integer variable represents the current setting for the minimum output intensity of red for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetRedVideoBlackLevel for getting, SetRedVideoBlackLevel for setting. State variable LastChange for updates. value('redVideoBlackLevelMaxValue') This unsigned integer variable represents the current setting for the minimum output intensity of green for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetGreenVideoBlackLevel for getting, SetGreenVideoBlackLevel for setting. State variable LastChange for updates. value('greenVideoBlackLevelMaxValue') This unsigned integer variable represents the current setting for the minimum output intensity of blue for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetBlueVideoBlackLevel for getting, SetBlueVideoBlackLevel for setting. State variable LastChange for updates. value('blueVideoBlackLevelMaxValue') This unsigned integer variable represents the current setting for the "color quality" of white for the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device Action GetColorTemperature for getting, SetColorTemperature for setting. State variable LastChange for updates. value('colorTemperatureMaxValue') This signed integer variable represents the current level of compensation for horizontal distortion of the associated display device. Its value ranges from device-specific negative number to a device specific positive number. Zero does not need to be in the middle of this range, although it will be for most devices. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetHorizontalKeystone for getting, SetHorizontalKeystone for setting. State variable LastChange for updates. value('horizontalKeystoneMinValue') value('horizontalKeystoneMaxValue') This signed integer variable represents the current level of compensation for vertical distortion of the associated display device. Its value ranges from device-specific negative number to a device specific positive number. Zero does not need to be in the middle of this range, although it will be for most devices. A numerical change of 1 corresponds to the smallest incremental change that is supported by the device. Action GetVerticalKeystone for getting, SetVerticalKeystone for setting. State variable LastChange for updates. value('verticalKeystoneMinValue') value('verticalKeystoneMaxValue') This set contains audio settings per channel, for the selected media renderer. Lower value limit for channel-specific variable volumeDB. For initialization, call UPnP action GetVolumeDBRange. Upper value limit for channel-specific variable volumeDB. For initialization, call UPnP action GetVolumeDBRange. "Mute" setting of the corresponding channel Action SetMute for setting, GetMute for getting. State variable LastChange for updates. Volume of corresponding channel Action SetVolume for setting, GetVolume for getting. State variable LastChange for updates. not(value('./chMute')) value('./chVolumeMaxValue') This signed integer variable represents the current volume setting of the associated audio channel. Its value represents the current setting in units of "1/256 of a decibel (dB)". This means that a numeric change of 1 corresponds to a volume change of 1/256 dB. The value range for this variable is a minimum value of -32,767 (800116) (which equals -127.9961dB) and a maximum value of +32,767 (7FFF16) (which equals +127.9961dB). The value corresponding to 800016 is invalid. If there is any chVolumeDB variable, chVolumeDB[Master] must be present. Note that each chVolumeDB variable has its own value space (type). UPnP action GetVolumeDB for getting, and SetVolumeDB for setting. State variable LastChange for updates. not(value('./chMute')) value('./chVolumeDBMinValue') value('./chVolumeDBMaxValue') This boolean variable represents the current "loudness" setting of the associated audio channel. A value of TRUE indicates that the loudness effect is active. UPnP action GetLoudness for getting, SetLoudness for setting. State variable LastChange for updates. not(value('./chMute')) Open a connection between the selected media server and media renderer for playing content. Command state shall reflect success or failure. After successful invocation, the "connections" set has a new actual index which specifies the newly created connection. Note: A connection may cause an error even after it has been successfully set up. In this case any of the notifications in set "conNotifications" will be raised. The user may choose an appropriate connection protocol as parameter. Otherwise the system will pick one. Identifier for new connection. This identifier can be used as index for the connections set to get access to the newly created connection. Note that command state must be "done" or "succeeded" after successful creation. Must be "noError" if command state is not "failed". This set contains the current connections (along the index of connection ids). Initially empty (no actual index). The user can create new connections by invoking the command "connect". The user can remove a connection by invoking the command "removeConnection". When populating this set with a new instance, the system is responsible for setting up a connection between media server and media renderer through the connection services on either end. Only successful connections will result in a new actual index. false() Close the connection that this command belongs to. UPnP action closeConnection on ConnectionService. Basic connection properties. Media server of the connection. UDN of media server. Friendly name of connected media server. Friendly name from device description. true() false() Media renderer of the connection. UDN of media renderer. Friendly name of connected media renderer. Friendly name from device description. true() false() This value reflects the details of the protocol used for the connection. ***** Elements in this set are based on AVTransport Service ***** Note: The UPnP commands GetMediaInfo, GetTransportInfo, GetPositionInfo, GetDeviceCapabilities and GetTransportSettings have no counterparts in the UI Socket since this information is already available through socket variables. Contains a static, comma-separated list of storage media that the device can play. UPnP action GetDeviceCapabilities for getting. No updates expected since static. Note: Since XSD has no means of defining the item type of a CSV list, we are implicitly using xsd:string here as item type. Correct item types are upnp-av:storageMedium.wc.values. false() false() Contains a static, comma-separated list of storage media onto which the device can record. UPnP action GetDeviceCapabilities for getting. No updates expected since static. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support recording). Note: Since XSD has no means of defining the item type of a CSV list, we are implicitly using xsd:string here as item type. Correct item types are upnp-av:storageMedium.wc.values. false() false() Contains a static, comma-separated list of recording quality modes that the device supports. For example, for an analog VHS recorder, the string would be "0:EP,1:LP,2:SP", while for a PVR the string would be "0:BASIC,1:MEDIUM,2:HIGH". The string specifics depend on the type of device containing the AVTransport. Note that record quality modes are independent of the content-format that may be exposed to the network through a ConnectionManager service. UPnP action GetDeviceCapabilities for getting. State variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support recording). Note: Since XSD has no means of defining the item type of a CSV list, we are implicitly using xsd:string here as item type. Correct item types are uis-upnp:recordQualityModeType. false() false() Indicates whether the play mode can be set by the user. True if UPnP action SetPlayMode is available, otherwise false. false() false() Indicates that the currentRecordQualityMode can be set by the user. True if UPnP action SetRecordQualityMode is present, otherwise false. Not present if value of UPnP variable CurrentRecordQualityMode is "NOT_IMPLEMENTED". false() false() Space-separated list of allowed values for variable transportPlaySpeed. Note: This cannot be defined as type since it may vary between devices. Retrieve actually supported speeds from the AVTransport service description, AllowedValueList for state variable TransportPlaySpeed. false() false() Conceptually 'top-level' state of the transport, e.g., whether it is playing, recording, etc. UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. true() false() This notification is raised when the transport service indicates an error. Active if TransportStatus is ERROR_OCCURRED. UPnP action GetTransportInfo for getting. LastChange for updates. false() Indicates the storage medium of the resource specified by AVTransportURI. If no resource is specified, then the state variable is set to "NONE". If AVTransportURI refers to a resource received from the UPnP network the state variable is set to "NETWORK". Device vendors may extend the specified allowed value list of this variable. For example, various types of solid-state media formats may be added in a vendor-specific way. UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. false() Indicates the storage medium where the resource specified by AVTransportURI will be recorded when a Record action is issued. If no resource is specified, then the state variable is set to "NONE". Device vendors may extend the allowed value list of this variable. For example, various types of solid-state media formats may be added in a vendor-specific way. UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support recording). true() false() Indicates the current play mode (e.g., random play, repeated play, etc.). This notion is typical for CD-based audio media, but is generally not supported by tape-based media. Value "DIRECT_1" indicates playing a single track and then stop (don't play the next track). Value "INTRO" indicates playing a short sample (typically 10 seconds or so) of each track on the media. Other play mode values are self explanatory. UPnP action GetTransportSettings for getting. State variable LastChange for updates. true() value('./isCurrentPlayModeSettable') String representation of a rational fraction, indicates the speed relative to normal speed. Example values are '1', '1/2', '2', '-1', '1/10', etc. Actually supported speeds can be retrieved from the AllowedValueList of this state variable in the AVTransport service description. Value '1' is required, value '0' is not allowed. UPnP action GetTransportInfo for getting. UPnP state variable LastChange for updates. true() true() Write protection status of currently loaded media. NOT_WRITABLE indicates an inherent 'read-only' media (e.g., a DVD-ROM disc) or the device doesn't support recording on the current media. PROTECTED indicates a writable media that is currently write-protected (e.g., a protected VHS tape). If no media is loaded, the write status will be "UNKNOWN". UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support recording). true() false() Indicates the currently set record quality mode. Such a setting takes the form of "Quality Ordinal:label". The Quality Ordinal indicates a particular relative quality level available in the device, from 0 (lowest quality) to n (highest quality). The label associated with the ordinal provides a human-readable indication of the ordinal's meaning. UPnP action GetTransportSettings for getting value. State variable LastChange for updates. Action SetRecordQualityMode for setting. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support recording). true() value('./recordQualityModeSettable') Number of tracks controlled by the AVTransport instance. If no resource is associated with the AVTransport instance (via SetAVTransportURI), and there is no 'default' resource (for example, a loaded disc) then NumberOfTracks shall be 0. Otherwise, it shall be 1 or higher. UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. true() false() If NumberOfTracks is 0, then CurrentTrack will be 0. Otherwise, this state variable will contain the sequence number of the currently selected track, starting at value '1', up to and including NumberOfTracks. For tape-based media that do not support the notion of tracks, this state variable will always be '1'. For LD and DVD media, the notion of track equals the notion of chapter number. For Tuners that provide an indexed list of channels, the current track is defined as the current index number in such a list. UPnP action GetPositionInfo for getting. UPnP state variable LastChange for updates. true() false() Duration of the current track, specified as a string of the following form: H+:MM:SS[.F+] or H+:MM:SS[.F0/F1] UPnP action GetPositionInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support media duration information). true() false() Duration of the current track, specified as a string of the following form: H+:MM:SS[.F+] or H+:MM:SS[.F0/F1] UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED" (i.e. service doesn't support media duration information). false() Id of the node from content that is currently in focus for playing. Serves as parameter for a connect and play operation. false() Metadata, in the form of a 1-dimensional array containing the metadata fields pertaining to the resource pointed to by state variable CurrentTrackURI. The meta data may have been extracted from state variable AVTransportURIMetaData, or extracted from the resource binary itself (e.g., embedded ID3 tags for MP3 audio). This is implementation dependent. Note: This variable reflects the content of the item currently being played, whereas the variable "metadata" in set "content" contains the metadata of the currently selected node. Also, currentTrackMetaData cannot be derived from the selected node and metadata, since the current selection may be the containing folder of the item currently being played. UPnP action GetPositionInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED". true() false() Reference, in the form of a URI, to the current track. The URI enables a control point to retrieve any meta data associated with current track, such as, for example, title and author information, via the ContentDirectory service. UPnP action GetPositionInfo for getting. UPnP state variable LastChange for udates. false() false() Reference, in the form of a URI of the resource controlled by the AVTransport instance. This URI may refer to a 'single' item (e.g., a song) or to a collection of items (e.g., a playlist). In the single item case, the AVTransport will have 1 'track' and AVTransportURI is equal to CurrentTrackURI. In the 'collection of items' case, the AVTransport will have multiple tracks, and AVTransportURI will remain constant during track changes. The URI enables a control point to retrieve any meta data associated with the AVTransport instance, such as, for example, title and author information, via the ContentDirectory service. UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. This is read-only since the command play will set avTransportUri to the desired URI. false() false() Metadata, in the form of a 1-dimensional array containing the metadata fields pertaining to the resource pointed to by state variable AVTransportURI. See the ContentDirectory service specification for details. If the service implementation doesn't support this feature then this state variable must be set to value "NOT_IMPLEMENTED". UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED". true() false() AVTransportURI value to be played when the playback of the current AVTransportURI finishes. Setting this variable ahead of time (via action SetNextAVTransportURI) enables a device to provide seamless transitions between resources for certain streaming protocols that need buffering (e.g. HTTP GET). UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. For setting call UPnP action SetNextAVTransportURI. Not present if value is "NOT_IMPLEMENTED" (i.e. the service doesn't support this feature). false() true() Metadata, in the form of a 1-dimensional array containing the metadata fields pertaining to the resource pointed to by state variable NextAVTransportURI. See the ContentDirectory service specification for details. If the service implementation doesn't support this feature then this state variable must be set to value "NOT_IMPLEMENTED". UPnP action GetMediaInfo for getting. UPnP state variable LastChange for updates. Not present if value is "NOT_IMPLEMENTED". true() false() Duration in the following form: H+:MM:SS[.F+] or H+:MM:SS[.F0/F1]. This state variable contains the current position, in terms of time, from the beginning of the current track. For tape-based media that do not support multiple tracks on a single tape, this state variable contains the position, in terms of time, from a zero reference point on the tape. The time format is the same as for state variable CurrentTrackDuration. UPnP action GetPositionInfo for getting and polling (no updates through LastChange). Not present if value is "NOT_IMPLEMENTED" (i.e. the service doesn't support relative time based position information). true() false() Duration in the following form: H+:MM:SS[.F+] or H+:MM:SS[.F0/F1] This state variable contains the current position, in terms of a time, from the beginning of the media. The time format is the same as for state variable CurrentTrackDuration. UPnP action GetPositionInfo for getting and polling (no updates through LastChange). Not present if value is "NOT_IMPLEMENTED" or "END_OF_MEDIA" (i.e. the service doesn't support time position information). Note: The UPnP spec allows for devices that don't support time position information to use the value "END_OF_MEDIA" to indicate the end of the current media. This information is lost in the Socket in favor of a more rigid approach. true() false() This state variable contains the current position, in terms of a dimensionless counter, from the beginning of the current track. For tape-based media that do not support multiple tracks on a single tape, this state variable contains the position, in terms of a dimensionless counter, from a zero reference point on the tape. UPnP action GetPositionInfo for getting and poling (no updates through LastChange). Not present if value is maximum value of the i4 data type (i.e. the service doesn't support relative count-based position information). true() false() This state variable contains the current position, in terms of a dimensionless counter, from the beginning of the loaded media. UPnP action GetPositionInfo for getting and polling (no updates through LastChange). Not present if value is maximum value of the i4 data type (i.e. the service doesn't support absolute count-based position information). true() false() This state variable contains a comma-separated list of transport-controlling actions that can be successfully invoked for the current resource at this specific point in time. The list will contain a subset of the following actions: Play, Stop, Pause, Seek, Next, Previous and Record. For example, when a live stream from the Internet is being controlled, the variable may be only "Play, Stop". When a local audio CD is being controlled, the variable may be "Play, Stop, Pause, Seek, Next, Previous". This information can be used, for example, to dynamically enable or disable play, stop, pause buttons, etc., on a user interface. UPnP action GetCurrentTransportActions for getting. State variable LastChange for updates. Note: We could define a type for valid transportActions but that would not help here since XML Schema doesn't allow us to define the item type of a CSV list. Note: We could use this variable for the execute dependencies of play, stop, etc., but might have the following problems: (1) This variable is optional, so may not be present. One could check this at runtime, but if not present, all commands would always be active. (2) Since this variable isn't directly evented, variable changes will arrive with delay through LastChange or with delay through polling. false() false() This action stops the progression of the current resource that is associated with the specified instance. Additionally, it is recommended that the "output of the device" (defined below) should change to something other than the current snippet of resource. Although the exact nature of this change varies from device to device, a common behavior is to immediately cease all "output" from the device. Nevertheless, the exact behavior is defined by the manufacturer of the device. This action is allowed in all transport states except in state "NO_MEDIA_PRESENT". Action Stop. true() value('./transportState')!='NO_MEDIA_PRESENT' value('./transportState') eq 'STOPPED' Start playing the resource of the specified instance, at the specified speed, starting at the current position, according to the current play mode. Keep playing until the resource ends or the transport state is changed via actions Stop or Pause. The device should do a 'best effort' to match the specified play speed. Actually supported speeds can be retrieved from the AllowedValueList of the TransportPlaySpeed state variable in the AVTransport service description. This action is allowed in the "STOPPED", "PLAYING", and "PAUSED_PLAYBACK" transport states. If no connection established yet, call UPnP action PrepareForConnection. Note that ConnectionComplete should be called when the session ends. UPnP action setAVTransportUri with the URI pertaining to the selectedBrowseId of xmlContent. Then invoke action Play; the command's state should be 'inProgress' as long as transportState has value 'TRANSITIONING'. value('./transportState') eq 'STOPPED' or value('./transportState') eq 'PAUSED_PLAYBACK' or value('./transportState') eq 'PLAYING' value('./transportState') eq 'PLAYING' Either one of the following: "SingleBrowse" = Play selectedBrowseId item from browse list. "SingleSearch" = Play selectedSearchId item from search list. "ContinuousBrowse" = Play items from browse list, starting with selectedBrowseId. "ContinuousSearch" = Play items from search list, starting with selectedSearchId. Indicates the desired play mode (e.g., random play, repeated play, etc.). Ignored if play mode cannot be set for the media renderer. This parameter should be ignored if UPnP action SetPlayMode is not present (optional). While the device is in a playing state, e.g. TransportState is "PLAYING", this action halts the progression of the resource that is associated with the specified instance Id. Any visual representation of the resource should remain displayed in a static manner (e.g. the last frame of video should remain displayed). Any audio representation of the resource should be muted. The difference between Pause() and Stop() is that Pause() MUST remain at the current position within the resource and the current resource must persist as describe above (e.g. the current video resource continues to be transmitted/displayed). This action is always allowed while playing or recording. UPnP action Pause. true() value('./transportState') eq 'PLAYING' or value('./transportState') eq 'RECORDING' value('./transportState') eq 'PAUSED_RECORDING' or value('./transportState') eq 'PAUSED_PLAYBACK' Is play available or not? false() false() Is stop available or not? false() false() Is pause available or not? false() false() Start recording on the specified transport instance, at the current position on the media, according to the currently specified recording quality, and return immediately. If AVTransportURI is set (differs from the empty string) then that resource will be recorded. If no AVTransportURI is set (equals the empty string), then the source of the content being recording is device dependent. In both cases, whether the device outputs the resource to a screen or speakers while recording is device dependent. If the device implementing the Record action also has a ContentDirectory service, then recorded content will be added to this ContentDirectory in a device-dependent way. Specifically, there is no UPnP mechanism to specify the location of the recorded content in the ContentDirectory hierarchy. This action is allowed in the "STOPPED" or "PAUSED_RECORDING" transport states. UPnP action Record. true() value('./transportState') eq 'STOPPED' or value('./transportState') eq 'PAUSED_RECORDING' value('./transportState') eq 'RECORDING' Start seeking through the resource controlled by the specified instance - as fast as possible - to the specified target position. Unit value "TRACK_NR" indicates seeking to a particular track number. For tape-based media that do not support the notion of track (such as VCRs), Seek("TRACK_NR","1") is equivalent to the common "FastReverse" VCR functionality. Special track number '0' is used to indicate the end of the media, hence, Seek("TRACK_NR","0") is equivalent to the common "FastForward" VCR functionality. This action is allowed in the STOPPED and PLAYING transport states. UPnP action Seek. If invoked, its state should be 'inProgress' as long as transportState has value 'TRANSITIONING'. true() value('./transportState') eq 'STOPPED' or value('./transportState') eq 'PLAYING' This parameter indicates the allowed units in which the amount of seeking to be performed is specified. It can be specified as a time (relative or absolute), a count (relative or absolute), a track number, a tape-index (e.g., for tapes with a indexing facility) or even a video frame. A device vendor is allowed to implement a subset of the allowed value list of this state variable. Only value 'TRACK_NR' is required. This parameter indicates the target position of the seek action, in terms of units defined by parameter unit. The data type of this variable is 'string'. However, depending on the actual seek mode used, it must contains string representations of values of UPnP types 'ui4' (ABS_COUNT, REL_COUNT, TRACK_NR, TAPE-INDEX, FRAME), 'time' (ABS_TIME, REL_TIME) or 'float' (CHANNEL_FREQ, in Hz). Supported ranges of these integer, time or float values are device-dependent. Convenient action to advance to the next track. This action is functionally equivalent to Seek(TRACK_NR,CurrentTrackNr+1). This action does not 'cycle' back to the first track. This action is allowed in the STOPPED and PLAYING transport states. UPnP action Next. If invoked, its state should be 'inProgress' as long as transportState has value 'TRANSITIONING'. true() value('./transportState') eq 'STOPPED' or value('./transportState') eq 'PLAYING' Convenient action to advance to the previous track. This action is functionally equivalent to Seek(TRACK_NR,CurrentTrackNr-1) . This action does not 'cycle' back to the last track. This action is allowed in the STOPPED and PLAYING transport states. UPnP action Previous. If invoked, its state should be 'inProgress' as long as transportState has value 'TRANSITIONING'. true() value('./transportState') eq 'STOPPED' or value('./transportState') eq 'PLAYING' Is play available or not? false() false() Is stop available or not? false() false() Is pause available or not? false() false() This set contains notifications that can occur for a running connection. ***** Elements in this set are based on ConnectionManager Service ***** This set defines notifications to be raised after a connection has been created. Errors upon creating a connection should be indicated through the "connectionError" parameter of the "connect" command. This notification is raised when the connection cannot be continued because of a protocol/format mismatch. Raised when GetCurrentConnectionInfo(Status)=="ContentFormatMismatch". false() This notification is raised when connection cannot be continued because of unsufficient network resources (bandwidth, channels, etc.). Raised when GetCurrentConnectionInfo(Status)=="InsufficientBandwidth". false() This notification is raised when connection cannot be continued because an unreliable channel has been chosen. Raised when GetCurrentConnectionInfo(Status)=="UnreliableChannel". false() This notification is raised when connection cannot be continued because of an unknown error. Raised when GetCurrentConnectionInfo(Status)=="Unknown". false() This type defines the possible indices for the metadata variable. The indices are strings based on the DIDL-LITE schema file and the metadata information it defines. Note that this type does not define the XML elements, but rather enumerates their identifiers as strings (in the form of "prefix:name"). In the future, other namespaces may be added for additional metadata types, e.g. for an EPG.