diff options
| author | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
|---|---|---|
| committer | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
| commit | 54b6cfa9a9e5b861a9930af873580d6dc20f773c (patch) | |
| tree | 35051494d2af230dce54d6b31c6af8fc24091316 /docs/html/guide/appendix/app-intents.jd | |
| download | frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.zip frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.gz frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.bz2 | |
Initial Contribution
Diffstat (limited to 'docs/html/guide/appendix/app-intents.jd')
| -rw-r--r-- | docs/html/guide/appendix/app-intents.jd | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/docs/html/guide/appendix/app-intents.jd b/docs/html/guide/appendix/app-intents.jd new file mode 100644 index 0000000..102183b --- /dev/null +++ b/docs/html/guide/appendix/app-intents.jd @@ -0,0 +1,106 @@ +page.title=Reference of Available Intents +@jd:body + +<p>This document describes the default applications and settings that Google provides + in their standard Android implementation. </p> +<h3>Intents handled by Google Android applications<a name="googleintents" id="googleintents"></a></h3> + <p> Android ships with Activities that handle the following Intent URI/Action pairs. </p> + <table width="100%" border="1"> + <tr> + <th scope="col">Scheme</th> + <th scope="col">Action<br /> + android.intent.action.<em>value</em></th> + <th scope="col">Description</th> + </tr> + <tr> + <td>http://<em>web_address</em><br /> + https://<em>web_address</em></td> + <td>VIEW</td> + <td>Open a browser window to the URL specified. </td> + </tr> + <tr> + <td>"" (empty string) <br /> + http://<em>web_address</em><br /> + https://<em>web_address</em></td> + <td>WEB_SEARCH</td> + <td>Opens the file at the location on the device in the browser. </td> + </tr> + <tr> + <td height="103">tel: <em>phone_number</em></td> + <td>CALL</td> + <td><p>Calls the entered phone number. Valid telephone numbers as defined + in <a href="http://tools.ietf.org/html/rfc3966">the IETF RFC 3966</a> are + accepted. Valid examples include the following:</p> + <ul> + <li>tel:2125551212 </li> + <li>tel: + (212) 555 1212</li> + </ul> + <p>The dialer is good at normalizing some kinds of schemes: for example + telephone numbers, so the schema described isn't strictly required + in the {@link android.net.Uri#parse(java.lang.String) + Uri(URI string)} factory. However, if you have not tried a + schema or are unsure whether it can be handled, use the {@link + android.net.Uri#fromParts(java.lang.String, java.lang.String, + java.lang.String) Uri.fromParts(scheme, ssp, fragment)} factory + instead.</p> + <p><strong><em>Note:</em></strong> This requires your + application to request the following permission in your manifest: <code><uses-permission + id="android.permission.CALL_PHONE" /></code></p></td> + </tr> + <tr> + <td><p>tel:<em>phone_number</em><br /> + voicemail:</p> </td> + <td>DIAL</td> + <td><p>Dials (but does not actually initiate the call) the number given + (or the stored voicemail on the phone). Telephone number normalization + described for CALL applies to DIAL as well. </p> </td> + </tr> + <tr> + <td>geo:<em>latitude</em>,<em>longitude</em><br /> + geo:<em>latitude</em>,<em>longitude</em>?z=<em>zoom</em><br /> + geo:0,0?q=<em>my+street+address</em><br /> + geo:0,0?q=<em>business+near+city</em><br /> + </td> + <td>VIEW</td> + <td>Opens the Maps application to the given location or query. The Geo URI scheme + (not fully supported) is <a href="http://tools.ietf.org/html/draft-mayrhofer-geo-uri-00">currently under + development</a>.<p> + The <em>z</em> field specifies the zoom level. A zoom level of 1 shows the whole Earth, centered at the + given <em>lat</em>,<em>lng</em>. A zoom level of 2 shows a quarter of the Earth, and so on. The highest + zoom level is 23. A larger zoom level will be clamped to 23. + </td> + </tr> + <tr> + <td>google.streetview:cbll=<em>lat</em>,<em>lng</em>&cbp=1,<em>yaw</em>,,<em>pitch</em>,<em>zoom</em>&mz=<em>mapZoom</em> + </td> + <td>VIEW</td> + <td>Opens the Street View application to the given location. The URI scheme is + based on the syntax used for Street View panorama information in Google Maps URLs.<p> + The cbll field is required. The cbp and mz fields are optional.<p> + <table border="1"> + <tr><th>Parameter</th><th>Description</th></tr> + <tr><td>lat</td><td>latitude</td></tr> + <tr><td>lng</td><td>longitude</td></tr> + <tr><td>yaw</td><td>Panorama center-of-view in degrees clockwise from North.<br /> + <b>Note:</b> The two commas after the yaw parameter are required. They are present + for backwards-compatibility reasons.</td></tr> + <tr><td>pitch</td><td>Panorama center-of-view in degrees from + -90 (look straight up) to 90 (look straight down.)</td></tr> + <tr><td>zoom</td><td>Panorama zoom. 1.0 = normal zoom, 2.0 = zoomed in 2x, 3.0 = zoomed in 4x, and so on.<br /> + A zoom of 1.0 is 90 degree horizontal FOV for a nominal + landscape mode 4 x 3 aspect ratio display. + Android phones in portrait mode will adjust the zoom so that + the vertical FOV is approximately the same as the landscape vertical + FOV. This means that the horizontal FOV of an Android phone in portrait + mode is much narrower than in landscape mode. This is done to minimize + the fisheye lens effect that would be present if a 90 degree horizontal + FOV was used in portrait mode.</td></tr> + <tr><td>mapZoom</td><td>The map zoom of the map location associated with this panorama. This value is passed on to the + Maps activity when the Street View "Go to Maps" menu item is chosen. It corresponds to the <em>z</em> paramaeter in + the geo: intent.</td></tr> + </table> + </td> + </tr> + </table> + <p></p> |