tv/start/hardware.jd

page.title= TV
page.tags=tv
trainingnavtop=true

@jd:body

<div id="tb-wrapper">
<div id="tb">
  <h2></h2>
  <ol>
    <li><a href="#runtime-check">TV </a>
    <li><a href="#handle-features"></a></li>
    <li><a href="#controllers"> </a>
    </li>
  </ol>
</div>
</div>

<p>
  TV  Android TV GPS  Android  TV 2  TV TV  TV
</p>

<p>
  TV  TV
</p>


<h2 id="runtime-check">TV </h2>

<p>
  TV {@link android.content.Intent}
</p>

<p>
  TV {@link android.app.UiModeManager#getCurrentModeType UiModeManager.getCurrentModeType()}  TV TV
</p>

<pre>
public static final String TAG = "DeviceTypeRuntimeCheck";

UiModeManager uiModeManager = (UiModeManager) getSystemService(UI_MODE_SERVICE);
if (uiModeManager.getCurrentModeType() == Configuration.UI_MODE_TYPE_TELEVISION) {
    Log.d(TAG, "Running on a TV Device")
} else {
    Log.d(TAG, "Running on a non-TV Device")
}
</pre>


<h2 id="handle-features"></h2>

<p>
   TV
</p>


<h3 id="unsupported-features"> TV </h3>

<p>
  TV  Android Android  TV
</p>

<table>
  <tr>
    <th></th>
    <th>Android  Feature Descriptor</th>
  </tr>
  <tr>
    <td></td>
    <td>{@code android.hardware.touchscreen}</td>
  </tr>
  <tr>
    <td></td>
    <td>{@code android.hardware.telephony}</td>
  </tr>
  <tr>
    <td></td>
    <td>{@code android.hardware.camera}</td>
  </tr>
  <tr>
    <td>NFC</td>
    <td>{@code android.hardware.nfc}</td>
  </tr>
  <tr>
    <td>GPS</td>
    <td>{@code android.hardware.location.gps}</td>
  </tr>
  <tr>
    <td></td>
    <td>{@code android.hardware.microphone}</td>
  </tr>
</table>


<h3 id="declare-hardware-requirements">TV </h3>

<p>
  Android TV TV
</p>

<p>
   TV TV  TV TV
</p>

<pre>
&lt;uses-feature android:name="android.hardware.touchscreen"
        android:required="false"/&gt;
&lt;uses-feature android:name="android.hardware.telephony"
        android:required="false"/&gt;
&lt;uses-feature android:name="android.hardware.camera"
        android:required="false"/&gt;
&lt;uses-feature android:name="android.hardware.nfc"
        android:required="false"/&gt;
&lt;uses-feature android:name="android.hardware.gps"
        android:required="false"/&gt;
&lt;uses-feature android:name="android.hardware.microphone"
        android:required="false"/&gt;
</pre>

<p>
  TV <a href="{@docRoot}training/tv/start/start.html#no-touchscreen">TV </a> 1  {@code android:required}  {@code false}
</p>

<p class="caution">
  <strong>:</strong> {@code true} TV Android  TV
</p>

<p>

</p>

<p>
  <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code uses-feature}</a>
</p>


<h3 id="hardware-permissions"></h3>

<p>
  <a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">{@code uses-permission}</a> <em></em> TV
</p>

<table>
  <tr>
    <th></th>
    <th></th>
  </tr>
  <tr>
    <td>{@link android.Manifest.permission#RECORD_AUDIO}</td>
    <td>{@code android.hardware.microphone}</td>
  </tr>
  <tr>
    <td>{@link android.Manifest.permission#CAMERA}</td>
    <td>{@code android.hardware.camera} <em></em> <br/> {@code android.hardware.camera.autofocus}</td>
  </tr>
  <tr>
    <td>{@link android.Manifest.permission#ACCESS_COARSE_LOCATION}</td>
    <td>{@code android.hardware.location} <em></em> <br/> {@code android.hardware.location.network}</td>
  </tr>
  <tr>
    <td>{@link android.Manifest.permission#ACCESS_FINE_LOCATION}</td>
    <td>{@code android.hardware.location} <em></em> <br/> {@code android.hardware.location.gps}</td>
  </tr>
</table>

<p>
  <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions-features">{@code uses-feature}</a> <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code uses-feature}</a> {@code android:required="false"}
</p>


<h3 id="check-features"></h2>

<p>
  Android {@link android.content.pm.PackageManager#hasSystemFeature(String)}
</p>

<p></p>

<pre>
// Check if the telephony hardware feature is available.
if (getPackageManager().hasSystemFeature("android.hardware.telephony")) {
    Log.d("HardwareFeatureTest", "Device can make phone calls");
}

// Check if android.hardware.touchscreen feature is available.
if (getPackageManager().hasSystemFeature("android.hardware.touchscreen")) {
    Log.d("HardwareFeatureTest", "Device has a touch screen.");
}
</pre>


<h4 id="no-touchscreen"></h4>

<p>
  TV Android  TV  10  TV
</p>

<p>
  TV TV  TV <a href="{@docRoot}training/tv/start/navigation.html">TV </a>
</p>


<h4 id="no-camera"></h4>

<p>
  TV TV TV
</p>

<pre>
&lt;uses-feature android:name="android.hardware.camera" android:required="false" /&gt;
</pre>

<p>

</p>

<pre>
// Check if the camera hardware feature is available.
if (getPackageManager().hasSystemFeature("android.hardware.camera")) {
    Log.d("Camera test", "Camera available!");
} else {
    Log.d("Camera test", "No camera available. View and edit features only.");
}
</pre>


<h4 id="no-gps">GPS</h4>

<p>
  TV GPSTV
</p>

<pre>
// Request a static location from the location manager
LocationManager locationManager = (LocationManager) this.getSystemService(
        Context.LOCATION_SERVICE);
Location location = locationManager.getLastKnownLocation("static");

// Attempt to get postal or zip code from the static location object
Geocoder geocoder = new Geocoder(this);
Address address = null;
try {
  address = geocoder.getFromLocation(location.getLatitude(),
          location.getLongitude(), 1).get(0);
  Log.d("Zip code", address.getPostalCode());

} catch (IOException e) {
  Log.e(TAG, "Geocoder error", e);
}
</pre>


<h2 id="controllers"></h2>

<p>
  TV 2
</p>


<h3 id="d-pad-minimum"></h3>

<p>
  TV  [][][]  TV TV <a href="{@docRoot}training/tv/start/navigation.html">TV </a>
</p>


<h3 id="controller-disconnects"></h3>

<p>
  TV  Bluetooth   TV
</p>

<ul>
  <li> TV
  </li>
  <li>
  </li>
  <li>
  </li>
</ul>

<p>
   TV
</p>

<pre>
&lt;activity
  android:name="com.example.android.TvActivity"
  android:label="&#64;string/app_name"
  <strong>android:configChanges="keyboard|keyboardHidden|navigation"</strong>
  android:theme="&#64;style/Theme.Leanback"&gt;

  &lt;intent-filter&gt;
    &lt;action android:name="android.intent.action.MAIN" /&gt;
    &lt;category android:name="android.intent.category.LEANBACK_LAUNCHER" /&gt;
  &lt;/intent-filter&gt;
  ...
&lt;/activity&gt;
</pre>

<p>
  Android
</p>


<h3 id="d-pad-variants"></h3>

<p>
  TV  TV TV
</p>

<p>
  <a href="{@docRoot}training/game-controllers/controller-input.html#dpad"></a>
</p>