<doc>
	<legacy_id></legacy_id>
	<name>iphoneSetRemoteControlDisplay</name>
	<type>command</type>

	<syntax>
		<example>iphoneSetRemoteControlDisplay <i>displayData</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Configures the information displayed on the remote control device, or on the (locked) home screen controls.</summary>

	<examples>
<example>iphoneSetRemoteControlDisplay pDisplayDataArray</example>
	</examples>

	<history>
		<introduced version="6.1">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="iphoneRemoteControlEnabled">iphoneRemoteControlEnabled Function</function>
		<command tag="iphoneDisableRemoteControl">iphoneDisableRemoteControl Command</command>
		<command tag="iphoneEnableRemoteControl">iphoneEnableRemoteControl Command</command>
		<command tag="iphoneSetAudioCategory">iphoneSetAudioCategory Command</command>
		<message tag="remoteControlReceived">remoteControlReceived Message</message>
	</references>

	<description>
	<overview>Use the <b>iphoneSetRemoteControlDisplay</b> command to configure the information displayed on the remote control device, or on the (locked) home screen controls.</overview>

		<parameters>
  <parameter>
    <name>displayData</name>
    <description>An array with one or more of the following keys</description>
    <options title="">
      <option>
        <item>title</item>
        <description>string</description>
      </option>
      <option>
        <item>artist</item>
        <description>string</description>
      </option>
      <option>
        <item>artwork</item>
        <description>Either the text of an image or an image filename.</description>
      </option>
      <option>
        <item>composer</item>
        <description>string</description>
      </option>
      <option>
        <item>genre</item>
        <description>string</description>
      </option>
      <option>
        <item>album title</item>
        <description>string</description>
      </option>
      <option>
        <item>album track count</item>
        <description>number</description>
      </option>
      <option>
        <item>album track number</item>
        <description>number</description>
      </option>
      <option>
        <item>disk count</item>
        <description>number</description>
      </option>
      <option>
        <item>disk number</item>
        <description>number</description>
      </option>
      <option>
        <item>chapter count</item>
        <description>number</description>
      </option>
      <option>
        <item>chapter number</item>
        <description>number</description>
      </option>
      <option>
        <item>playback duration</item>
        <description>number</description>
      </option>
      <option>
        <item>elapsed playback time</item>
        <description>number</description>
      </option>
      <option>
        <item>playback rate</item>
        <description>number</description>
      </option>
      <option>
        <item>playback queue index</item>
        <description>number</description>
      </option>
      <option>
        <item>playback queue count</item>
        <description>number</description>
      </option>
    </options>
  </parameter>		</parameters>

	<value></value>
	<comments>The remote control feature on iOS allows access to the audio controls both on an external device and also on the device itself when in lock screen (via double-tapping on the Home button).<p></p><p>Use the <b>iphoneSetRemoteControlDisplay</b> command to configure the information that may be displayed on the remote control device, or on the (locked) home screen controls.</p><p></p><note>There is no guarantee that any of this information will be used, it is up to the remote control device / iOS to decide.</note><p></p><note>This functionality is only available on iOS 5.x and above.</note></comments>
	</description>
</doc>