Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 27f7c240 authored by Robert Ly's avatar Robert Ly Committed by Joe Fernandez
Browse files

docs: Android TV Dev Guide, final (probably)

Change-Id: I5b333daa32ff9a50724151631661fab126b68704
parent 941f800a
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -721,6 +721,7 @@ LOCAL_DROIDDOC_OPTIONS:= \
		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
		-toroot / \
		-hdf android.whichdoc online \
		-briefdocs \
		$(sample_groups) \
		-hdf android.hasSamples true \
		-samplesdir $(samples_dir)
+282 −0
Original line number Diff line number Diff line
page.title=ADT-1 Developer Kit
page.tags="emote","e-mote","adt"

@jd:body

<div id="qv-wrapper">
<div id="qv">
  <h2>In this document</h2>
  <ol>
    <li><a href="#faq">Frequently Asked Questions</a>
      <ol>
        <li><a href="#setup">Device Setup</a></li>
        <li><a href="#input">User Input</a></li>
        <li><a href="#cast">Google Cast</a></li>
        <li><a href="#trouble">Troubleshooting</a></li>
      </ol>
    </li>
    <li><a href="#emote">Android TV Remote Control App</a></li>
    <li><a href="#reg-safety">Regulatory Disclosures and Safety</a></li>
  </ol>
</div>
</div>

<p>The ADT-1 Developer Kit is a streaming media player and game controller designed for running
and testing apps built for Android TV. Supplies of ADT-1 are limited and it is intended for
developers who are interested in building new apps or extending their existing apps to run on the
Android TV platform.</p>

<p class="note">
  <strong>Note:</strong> The ADT-1 kit <em>is not required</em> for building and testing apps
  for Android TV. You can build apps for TV and test them using an emulator for TV devices. The
  L Developer Preview includes all the software needed to build TV apps and an emulator for running
  and testing them. For more information, see the
  <a href="{@docRoot}preview/tv/start/index.html">Get Started</a> guide for TV apps.
</p>

<h2 id="faq">ADT-1 Frequently Asked Questions</h2>

<p>The following information is provided to help set up and use the ADT-1 device.</p>


<h3 id="setup">Device Setup</h3>

<p>
  <strong>How do I turn my device on?</strong>
</p>
<p>Plug the included power cable into the back of ADT-1. The device does not have an on/off
  switch.</p>

<p>
  <strong>How do I completely turn my device off? </strong>
</p>
<p>Unplug the included power cable from the back of ADT-1. The device does not have an on/off
  switch. However, ADT-1 will begin sleeping (daydream) based on user settings in
  <strong>Settings &gt; Display &gt; Daydream</strong>.
  </p>

<p>
  <strong>How do I connect to the network?</strong>
</p>
<p>ADT-1 has both wireless and Ethernet for connecting to your network. To change your wireless
  network, go to <strong>Settings -&gt; Wi-Fi</strong>. To use an Ethernet network connection,
  simply plug an Ethernet cable (that is connected to your network) into the port on the back of
  ADT-1.</p>

<p>
  <strong>How do I use the developer cable?</strong>
</p>
<p>The developer cable has three connectors: a small, male power connector that plugs into the
  power port on the back of ADT-1, a standard male USB-A connector that connects your PC, and a
  small, female power connector that the included power supply plugs into.</p>



<h3 id="input">User Input</h3>

<p>
  <strong>How do I put the gamepad that came with my ADT-1 into pairing mode?</strong>
</p>
<p>Press and hold the Back and Home buttons together for about three seconds, until all four
  blue LEDs flash together. When the LEDs are flashing, the gamepad is in pairing mode.</p>

<p>
  <strong>How do I use the gamepad with the on-screen keyboard?</strong>
</p>
<p>Use the D-pad or left joystick to move the cursor, and press A to select. Press X to delete a
  character, and press Y to insert a space. Also, you can press the right joystick to toggle caps
  lock, and press the left joystick to show additional symbols.</p>

<p>
  <strong>Can I control ADT-1 with my phone or tablet?</strong>
</p>
<p>Yes. In order to control the ADT-1 with Android phones or tablets, you can download a remote
  control app from the Google Play store. For more information, see <a href="#emote">Android TV
  Remote Control App</a>.
  </p>

<p>
  <strong>Can I connect a USB keyboard or mouse to ADT-1?</strong>
</p>
<p>Yes, you can connect a USB keyboard or mouse to the USB port on the back of ADT-1.

<p class="note">
  <strong>Note:</strong> The ADT-1 device is not compatible with all manufacturers and models of
  these devices. If a particular keyboard or mouse does not work, try a different model.
</p>

<p>
  <strong>How do I connect a Bluetooth device without an input device already attached?</strong>
</p>
<p>You can put ADT-1 into Bluetooth pairing mode using a hardware button. Press the small, round
  button on the back of ADT-1 to make it search for Bluetooth devices in pairing mode. If multiple
  accessories are found, press the small, round button to select the device you want to pair.
  Pairing will happen automatically after a few seconds.
</p>

<p>
  <strong>How do I connect additional Bluetooth accessories?</strong>
<p>
<p>To pair Bluetooth devices to ADT-1 from the user interface, go to <strong>Settings &gt;
  Remote &amp; Accessories &gt; Add accessory</strong>


<h3 id="cast">Google Cast</h3>

<p>
  <strong>Can I cast to an ADT-1 device?</strong>
<p>
<p>Yes. The ADT-1 includes Google Cast receiver functionality, similar to Chromecast. Since the
  ADT-1 is a developer device running a development software release, the Google Cast receiver is
  open only to a limited number of apps.</p>

<p>
  <strong>Which Cast apps are supported on ADT-1?</strong>
<p>
<p>As a developer device, the ADT-1 supports casting from only the following apps/websites:</p>

<ul>
  <li>YouTube</li>
  <li>Netflix</li>
  <li>Google+ Photos</li>
  <li>Google Play Movies and TV (Android only)</li>
</ul>

<p>Coming soon:</p>

<ul>
  <li>Google Play Music</li>
  <li>Google Play Movies and TV (iOS and Chrome)</li>
  <li>Mirror you Android device screen to ADT-1</li>
</ul>

<p class="note">
  <strong>Note:</strong> When casting from a Chrome browser, you must use Chrome V.36 or higher.
  Chrome V.36 is available in beta-channel and is planned to be released soon.
</p>

<p>
  <strong>How do I cast to ADT-1?</strong>
<p>
<p>You cast to an ADT-1 device the same way you do with a Chromecast device. Open the supported
  Cast apps or webpages, press the <strong>Cast</strong> button and you should see the ADT-1 as a
  Cast target. For more infomation about on how to cast, see
  <a href="http://www.google.com/intl/en/chrome/devices/chromecast/learn.html">Learn How to
  Cast</a>.
  </p>

<p>
  <strong>Will my Google Cast sender apps work on ADT-1 just like Chromecast?</strong>
<p>
<p>Yes. Your Cast app works on ADT-1 and Android TV products without additional work.<p>

<p class="note">
  <strong>Note:</strong> Your iOS sender app requires the Google Cast iOS API version 2.2.1
  or later to work with the ADT-1 device.
</p>

<p>
  <strong>How do I register my ADT-1 in order to run my apps?</strong>
</p>
<ol>
  <li>Go to <strong>Settings &gt; Google Cast</strong> and turn on developer support, allowing the
    ADT-1 device to send its serial number to Google.</li>
  <li>Register your ADT-1 device in the Google Cast Developer Console, using the 12 character
    serial number engraved on the back of the ADT-1.</li>
</ol>

<p>For more Google Cast developer information, see the
  <a href="https://developers.google.com/cast/">Cast developer site</a>. Please use the Google Cast
  SDK <a href="https://code.google.com/p/google-cast-sdk/issues/list">issue tracker</a> for filing
  issues related to Cast. Make sure you mention the ADT-1 device when filing an issue.
</p>

<p>
  <strong>How do I debug my Cast app on ADT-1?</strong>
</p>
<p>Connect your development platform using the power/USB cable, and using a Chrome browser,
  navigate to <code>chrome://inspect/#devices</code> to debug the webview.</p>


<h3 id="trouble">Troubleshooting</h3>

<p>
  <strong>Why doesn't the on-screen keyboard come up?</strong>
</p>
<p>Enable the keyboard in the device Settings. Go to <strong>Settings &gt; Keyboard &gt; Current
  keyboard</strong> and choose <strong>Leanback keyboard</strong>.

<p>
  <strong>How do I perform a hardware reboot?</strong>
</p>
<p>Locked it up, huh? No worries. We've done that a few times ourselves. Unplug and replug the
  included power cable from the back of ADT-1 to reboot it.
</p>

<p>
  <strong>How do I perform a factory reset?</strong>
</p>
<p class="warning">
  <strong>Warning:</strong> This procedure removes all data from the device, including system
  data, downloaded apps, app data, and account settings.
</p>

<p>From the home screen, go to <strong>Settings &gt; Device &gt; Factory data reset</strong>, and
  select <strong>Reset device</strong>.
</p>

<p>
  <strong>How do I perform a hardware reset?</strong>
</p>
<p class="warning">
  <strong>Warning:</strong> This procedure performs a factory data reset, removing all data from
  the device, including system data, downloaded apps, app data, and account settings.
</p>

<p>Unplug the power cable from the back of ADT-1. Press and hold the small, round button on the
  back of ADT-1 as you re-insert the power cable, and continue to hold the small round button. The
  LED will begin flashing red for a few seconds, then change to multi-color cycle. When the LED
  starts the multi-color cycle, release the small, round button, and ADT-1 boots up. If you release
  the button while the LED is flashing red, the device will be in Fastboot mode.</p>

<p>
  <strong>There is a hardware problem with my ADT-1. How do I return it?</strong>
</p>
<p>You can request a return of the device using the
  <a href="https://support.google.com/googleplay/android-developer/contact/adt_rma">return
  merchandise authorization form</a>.
</p>


<h2 id="emote">Android TV Remote Control App</h2>

<div class="figure" style="width:250px;margin-top:0">
<img src="/preview/tv/images/android-tv-remote.png" alt="Android TV Remote Screenshots">
</div>

<p>A remote control app is available for Android phones and tablets that allows you to interact
  with the ADT-1 device. This app allows you to switch between D-pad input mode or touchpad mode
  to navigate content and play games on a Android TV device. You can also tap the mic button to
  start a voice search, or use the keyboard to input text using this app.</p>

<p>You download the remote control app from the Google Play store using
  <a href="https://play.google.com/store/apps/details?id=com.google.android.tv.remote">this
  link</a>.
</p>

<p class="note">
  <strong>Note:</strong> your Android ​phone or tablet must be connected to the same local network
  as ADT-1.
</p>


<h2 id="reg-safety">Regulatory Disclosures and Safety Information</h2>

<p>The ADT-1 device comes with important regulatory disclosures and safety information. Please
read this information before using the device:</p>

<ul>
  <li><a href="regulatory.html">Regulatory Disclosures</a></li>
  <li><a href="safety.html">Important Safety Information</a></li>
</ul>
+79 −0
Original line number Diff line number Diff line
page.title=Regulatory Disclosures for ADT-1
parent.title=ADT-1 Developer Kit
parent.link=index.html

@jd:body

<p>Disclosures for the <a href="index.html">ADT-1</a> device.</p>

<p>
  Model: W2<br>
  FCC ID: A4R-W2<br>
  IC: 10395A-W2
</p>

<p>U.S. Federal Communications Commission Notices</p>
<p>To satisfy FCC and IC exposure requirements, a separation distance of at least 20 cm should
  be maintained between the antenna of this device and persons during device operation. Operations
  at closer than this distance are not recommended.</p>
<p>The antenna used for this transmitter must not be co-located in conjunction with any other
  antenna or transmitter.</p>
<p>This equipment has been tested and found to comply with the limits for a Class B digital
  device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable
  protection against harmful interference in a residential installation. This equipment generates,
  uses and can radiate radio frequency energy and, if not installed and used in accordance with the
  instructions, may cause harmful interference to radio communications. However, there is no
  guarantee that interference will not occur in a particular installation. If this equipment does
  cause harmful interference to radio or television reception, which can be determined by turning
  the equipment off and on, the user is encouraged to try to correct the interference by one or more
  of the following measures:</p>
<p>—Reorient or relocate the receiving antenna.</p>
<p>—Increase the separation between the equipment and receiver.</p>
<p>—Connect the equipment into an outlet on a circuit different from that to which the receiver
  is connected.</p>
<p>—Consult the dealer or an experienced radio/ TV technician for help.</p>
<p>This device complies with part 15 of the FCC Rules. Operation is subject to the following two
  conditions: (1) This device may not cause harmful interference, and (2) this device must accept
  any interference received, including interference that may cause undesired operation.</p>
<p>Changes or modifications not expressly approved by Google Inc. could void the user's
  authority to operate the equipment.</p>
<p>Industry Canada Notices</p>
<p>This device complies with Industry Canada licence-exempt RSS standard(s). Operation is
  subject to the following two conditions: (1) this device may not cause interference, and (2) this
  device must accept any interference, including interference that may cause undesired operation of
  the device.</p>
<p>Under Industry Canada regulations, this radio transmitter may only operate using an antenna
  of a type and maximum (or lesser) gain approved for the transmitter by Industry Canada. To reduce
  potential radio interference to other users, the antenna type and its gain should be so chosen
  that the equivalent isotropically radiated power (e.i.r.p.) is not more than that necessary for
  successful communication.</p>
<p>The radiated output power of the Wireless Device is below the Industry Canada (IC) radio
  frequency exposure limits. The Wireless Device should be used in such a manner such that the
  potential for human contact during normal operation is minimized.</p>

<hr />

<p>CAN ICES-3 (B)/NMB-3(B)</p>
<p>
  <u>Avis d’<em>Industrie Canada</em></u>
</p>
<p>
  Le présent appareil est conforme aux <em>CNR</em> d'Industrie Canada applicables aux appareils
  radio exempts de licence. L'exploitation est autorisée aux deux conditions suivantes : (1)
  l'appareil ne doit pas produire de brouillage, et (2) l'appareil doit accepter tout brouillage
  radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement.
</p>
<p>
  En vertu de la règlementation d’<em>Industrie Canada</em>, cet émetteur radio peut
    fonctionner avec une antenne d'un type et d'un gain maximal (ou inférieur) approuvé pour
    l'émetteur par <em>Industrie Canada</em>. Dans le but de réduire les risques de brouillage
  radioélectrique à l'intention des autres utilisateurs, il faut choisir le type d'antenne et son
  gain de sorte que la puissance isotrope rayonnée équivalente (p.i.r.e.) ne dépasse pas l'intensité
  nécessaire à l'établissement d'une communication satisfaisante.
</p>
<p>
  La puissance rayonnée en sortie de l'appareil sans fil est inférieure aux limites fixées par
  <em>Industrie Canada</em> en matière d'exposition aux radiofréquences. L'appareil sans fil
  doit être utilisé de sorte que la possibilité d'un contact humain pendant le fonctionnement
  normal soit limitée.
</p>
+140 −0
Original line number Diff line number Diff line
page.title=Important Safety Instructions for ADT-1
parent.title=ADT-1 Developer Kit
parent.link=index.html

@jd:body

<p>Safety information for the <a href="index.html">ADT-1</a> device.</p>

<p>
  <strong>WARNING:</strong> Read all safety information below before using this device to avoid
  injury.
</p>
<ul>
  <li><p>Do not install near heat sources, such as heaters and other devices.</p></li>
  <li><p>Use in a well-ventilated area and plug power adapter into an easily accessible
      outlet. Only use this device with the provided power adapter.</p></li>
  <li><p>The device has no on/off switch. To disconnect from power, you must unplug the
      power adapter.</p></li>
  <li><p>Only use indoors and do not expose to rain, liquid, moisture, excessive heat, or
      naked flame.</p></li>
  <li><p>Clean only with a dry cloth.</p></li>
</ul>
<p>
  <strong>WARNING:</strong> Playing video games has been linked to injuries in some
  users. Read all safety and health information below before using the gamepad to avoid possible
  injury.
</p>

<p><u>Photosensitive Seizures</u></p>

<p>
  A very small percentage of people may experience a seizure when exposed to certain visual images,
  including flashing lights or patterns that may appear in some video games, even people who have no
  history of seizures or epilepsy. These seizures have a variety of symptoms, including
  lightheadedness, altered vision, disorientation, loss of awareness, involuntary movements, loss of
  consciousness, or convulsions. If you experience any of these symptoms, <u>stop gaming
    immediately and consult your doctor</u>.
</p>

<p><u>Ergonomics</u></p>

<p>Long periods of repetitive motion using incorrect body positioning may be associated with
  physical discomfort and injuries to nerves, tendons, and muscles. If during or after gaming you
  feel pain, numbness, weakness, swelling, burning, cramping, or stiffness, <u>stop gaming
  and consult your doctor</u>.

<p>
  <strong>Healthy Gaming</strong>
</p>

<p>To reduce risk of seizures or injury, take the following precautions:</p>

<ul>
  <li><p>Sit as far away from the TV screen as possible.</p></li>
  <li><p>Play in a well-lit room.</p></li>
  <li><p>Do not play when you are drowsy or fatigued.</p></li>
  <li><p>Take 10-15 minute breaks every hour if playing video games and avoid prolonged
      gaming.</p></li>
</ul>

<p>
  <strong>Do Not Attempt Repairs Yourself</strong>
</p>

<p>There are no user-serviceable parts inside. Do not attempt to open or disassemble.</p>

<p>Failure to follow these safety instructions could result in fire, electric shock, damage to
  the device or other property, or personal injury.</p>

<hr />

<p>
  <strong>Importantes instructions concernant la sécurité</strong>
</p>

<p>
  <strong>ATTENTION:</strong> Veuillez lire toutes les informations de sécurité énoncées ci-bas
  avant d’utiliser l’appareil pour éviter des blessures.
</p>

<ul>
  <li><p>Ne pas installer à proximité d’une source de chaleur telle une chaufferette ou un
      autre appareil similaire.</p></li>
  <li><p>Utiliser dans un endroit bien aéré et brancher l’adaptateur électrique dans une
      prise de courant facilement accessible.</p></li>
  <li><p>L’appareil ne possède aucun interrupteur marché/arrêt. Pour mettre l’appareil hors
      tension, il faut débrancher l’appareil de la prise de courant.</p></li>
  <li><p>Utiliser l’appareil uniquement à l’intérieur et ne pas l’exposer à la pluie, à des
      substances liquides, à l’humidité, à la chaleur excessive ou à une flamme.</p></li>
  <li><p>Nettoyer uniquement avec un linge sec.</p></li>
</ul>

<p>
  <strong>ATTENTION:</strong> Le fait de jouer à des jeux vidéo a été relié à des blessures chez certains
  utilisateurs. Afin d’éviter de possibles blessures, veuillez lire toutes les informations
  concernant la sécurité et la santé énoncées ci-bas avant d’utiliser la tablette de jeu.
</p>

<p><u>Épilepsie photosensible</u></p>

<p>L’exposition à certaines images visuelles, incluant les lumières ou motifs clignotants qui
  peuvent apparaître dans certains jeux vidéo, peut provoquer chez un très faible pourcentage de
  personnes une crise d’épilepsie, et ce, même si ces personnes n’ont aucun historique de crises ou
  d’épilepsie. Ces crises comportent divers symptômes tels que des étourdissements, une vision
  altérée, un sentiment de désorientation, la perte de conscience, des mouvements involontaires, la
  perte de connaissance ou de conscience ou des convulsions. Si vous ressentez quelconque de ces
  symptômes, <u>cessez de jouer immédiatement et consultez votre médecin</u>.</p>

<p><u>Ergonomie</u></p>

<p>Les longues périodes de mouvements répétitifs effectués dans une position corporelle
  inadéquate peuvent mener à un inconfort physique et à des blessures aux nerfs, tendons et muscles.
  Si durant ou après avoir joué à des jeux vidéo, vous ressentez de la douleur, de
  l’engourdissement, une faiblesse, de l’inflammation, une sensation de brûlure, des crampes ou de
  la rigidité, <u>cessez de jouer immédiatement et consultez votre médecin</u>.</p>

<p>
  <strong>Le jeu sécuritaire</strong>
</p>

<p>Afin de réduire les risques de crises d’épilepsie ou de blessures, veuillez prendre les
  précautions suivantes :</p>

<ul>
  <li>Asseyez-vous aussi loin de l’écran de télévision que possible.</li>
  <li>Jouez dans une pièce munie d’un éclairage adéquat.</li>
  <li>Ne jouez pas lorsque vous êtes étourdi ou fatigué.</li>
  <li>Prenez 10 à 15 minutes de pause après chaque heure de jeu et évitez les périodes de jeu
  prolongées.</li>
</ul>

<p>
  <strong>Ne pas tenter d’effectuer des réparations par vous-même</strong>
</p>

<p>L’Appareil ne contient aucune pièce pouvant être réparée par l’utilisateur. Ne pas tenter
  d’ouvrir ou de désassembler l’Appareil.</p>

<p>Le défaut de suivre ces instructions de sécurité pourrait provoquer un feu, un choc
  électrique, un dommage à l’Appareil ou à d’autres objets ou des lésions corporelles.</p>
+70 −0

File added.

Preview size limit exceeded, changes collapsed.

Loading