Av:Developer:TimeService - Revision history

Simonc: /* Architectural Overview */

2013-08-02T10:58:34Z

Architectural Overview

← Older revision		Revision as of 10:58, 2 August 2013
Line 1:		Line 1:
-	= ~~Architectural~~ Overview =	+	= Overview =
	The Time service reports the duration of the currently playing track and the number of seconds played so far. It also maintains a count of the total number of tracks played.		The Time service reports the duration of the currently playing track and the number of seconds played so far. It also maintains a count of the total number of tracks played.

Simonc at 10:57, 2 August 2013

2013-08-02T10:57:49Z

← Older revision		Revision as of 10:57, 2 August 2013
Line 2:		Line 2:
	The Time service reports the duration of the currently playing track and the number of seconds played so far. It also maintains a count of the total number of tracks played.		The Time service reports the duration of the currently playing track and the number of seconds played so far. It also maintains a count of the total number of tracks played.

-	This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.	+	This service is intentionally separated from the [[Developer:InfoService\|Info]] service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The <tt>Time</tt> service is kept separate from the [[Developer:InfoService\|Info]] service so that control points can decide to subscribe to it independently.

	= State Variables =		= State Variables =
	== Track Count ==		== Track Count ==
-	The number of tracks that have been played, including any currently playing one. ~~(read-only)~~	+	The number of tracks that have been played, including any currently playing one.

	== Duration ==		== Duration ==
-	The total length of the current track in seconds. Zero for live streams. ~~(read-only)~~	+	The total length of the current track in seconds. Zero for live streams.

	== Seconds ==		== Seconds ==
-	The total length of time in seconds for which the current track has been playing. ~~(read-only)~~	+	The total length of time in seconds for which the current track has been playing.

	= Actions =		= Actions =
-	==Time==	+	== Time ==
-	This reports TrackCount, which increments each time a new track is played; Duration, which is the duration of the current track in seconds; and Seconds, which is the number of seconds so far played.	+	This reports <tt>TrackCount</tt>, which increments each time a new track is played; <tt>Duration</tt>, which is the duration of the current track in seconds; and <tt>Seconds</tt>, which is the number of seconds so far played.

-	TrackCount corresponds with TrackCount reported in the Info ~~Service~~, but bears no relation to a Track Id or Preset Id reported from the [[Developer:Davaar:PlaylistService\|Playlist ~~Service~~]] or [[Developer:Davaar:RadioService\|Radio ~~Service~~]].	+	<tt>TrackCount</tt> corresponds with <tt>TrackCount</tt> reported in the [[Developer:InfoService\|Info]] service, but bears no relation to a Track Id or Preset Id reported from the [[Developer:Davaar:PlaylistService\|Playlist]] or [[Developer:Davaar:RadioService\|Radio]] services.

	= Technical Details =		= Technical Details =

Johnh: added section on State Variables

2013-07-19T12:41:02Z

added section on State Variables

← Older revision		Revision as of 12:41, 19 July 2013
Line 3:		Line 3:

	This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.		This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.
		+
		+	= State Variables =
		+	== Track Count ==
		+	The number of tracks that have been played, including any currently playing one. (read-only)
		+
		+	== Duration ==
		+	The total length of the current track in seconds. Zero for live streams. (read-only)
		+
		+	== Seconds ==
		+	The total length of time in seconds for which the current track has been playing. (read-only)

	= Actions =		= Actions =

Johnh: /* Architectural Overview */ added mention of TrackCount

2013-07-19T12:34:48Z

Architectural Overview: added mention of TrackCount

← Older revision		Revision as of 12:34, 19 July 2013
Line 1:		Line 1:
	= Architectural Overview =		= Architectural Overview =
-	The Time service reports the duration of the currently playing track and the number of seconds so far played.	+	The Time service reports the duration of the currently playing track and the number of seconds played so far. It also maintains a count of the total number of tracks played.

	This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.		This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.

Openhome at 15:16, 5 May 2011

2011-05-05T15:16:12Z

← Older revision		Revision as of 15:16, 5 May 2011
Line 18:		Line 18:

	== Time Service Description (XML) ==		== Time Service Description (XML) ==
-	<~~code~~>	+	<syntaxhighlight lang="xml">
	<?xml version="1.0" encoding="utf-8"?>		<?xml version="1.0" encoding="utf-8"?>
	<scpd xmlns="urn:schemas-upnp-org:service-1-0">		<scpd xmlns="urn:schemas-upnp-org:service-1-0">
Line 62:		Line 62:
	</serviceStateTable>		</serviceStateTable>
	</scpd>		</scpd>
-	</~~code~~>	+	</syntaxhighlight>

Joshh: /* Time Service Description (XML) */

2011-05-05T14:13:35Z

Time Service Description (XML)

← Older revision		Revision as of 14:13, 5 May 2011
Line 19:		Line 19:
	== Time Service Description (XML) ==		== Time Service Description (XML) ==
	<code>		<code>
		+	<?xml version="1.0" encoding="utf-8"?>
		+	<scpd xmlns="urn:schemas-upnp-org:service-1-0">
		+	<specVersion>
		+	<major>1</major>
		+	<minor>0</minor>
		+	</specVersion>
		+	<actionList>
		+	<action>
		+	<name>Time</name>
		+	<argumentList>
		+	<argument>
		+	<name>TrackCount</name>
		+	<direction>out</direction>
		+	<relatedStateVariable>TrackCount</relatedStateVariable>
		+	</argument>
		+	<argument>
		+	<name>Duration</name>
		+	<direction>out</direction>
		+	<relatedStateVariable>Duration</relatedStateVariable>
		+	</argument>
		+	<argument>
		+	<name>Seconds</name>
		+	<direction>out</direction>
		+	<relatedStateVariable>Seconds</relatedStateVariable>
		+	</argument>
		+	</argumentList>
		+	</action>
		+	</actionList>
		+	<serviceStateTable>
		+	<stateVariable sendEvents="yes">
		+	<name>TrackCount</name>
		+	<dataType>ui4</dataType>
		+	</stateVariable>
		+	<stateVariable sendEvents="yes">
		+	<name>Duration</name>
		+	<dataType>ui4</dataType>
		+	</stateVariable>
		+	<stateVariable sendEvents="yes">
		+	<name>Seconds</name>
		+	<dataType>ui4</dataType>
		+	</stateVariable>
		+	</serviceStateTable>
		+	</scpd>
	</code>		</code>

Joshh: /* Technical Details */

2011-05-05T14:05:25Z

Technical Details

← Older revision		Revision as of 14:05, 5 May 2011
Line 16:		Line 16:
	Version : 1		Version : 1
	</code>		</code>
-	~~[http://oss.linn.co.uk/trac/browser/Main/LibUpnpCil/Services/Openhome/Time1.xml~~ Time Service Description (XML)]	+
		+	== Time Service Description (XML) ==
		+	<code>
		+	</code>

Keith: moved Developer:TimeService to Av:Developer:TimeService

2011-04-28T13:59:33Z

moved Developer:TimeService to Av:Developer:TimeService

← Older revision

Revision as of 13:59, 28 April 2011

Joshh: Created page with "= Architectural Overview = The Time service reports the duration of the currently playing track and the number of seconds so far played. This service is intentionally separated ..."

2011-04-28T12:29:09Z

Created page with "= Architectural Overview = The Time service reports the duration of the currently playing track and the number of seconds so far played. This service is intentionally separated ..."

New page

= Architectural Overview =
The Time service reports the duration of the currently playing track and the number of seconds so far played.

This service is intentionally separated from the Info service. When a track is being played, this service delivers an event every second, which can overwhelm some primitive control points. The Time service is kept separate from the Info service so that control points can decide to subscribe to it independently.

= Actions =
==Time==
This reports TrackCount, which increments each time a new track is played; Duration, which is the duration of the current track in seconds; and Seconds, which is the number of seconds so far played.

TrackCount corresponds with TrackCount reported in the Info Service, but bears no relation to a Track Id or Preset Id reported from the [[Developer:Davaar:PlaylistService|Playlist Service]] or [[Developer:Davaar:RadioService|Radio Service]].

= Technical Details =
<code>
Domain : av.openhome.org
Name : Time
Version : 1
</code>
[http://oss.linn.co.uk/trac/browser/Main/LibUpnpCil/Services/Openhome/Time1.xml Time Service Description (XML)]