summaryrefslogtreecommitdiffstats
path: root/docs/html/guide/appendix/app-intents.jd
blob: 102183bcae0463ada8226655dd3ff77a437e0012 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
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>&quot;&quot; (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>&nbsp;&nbsp;&nbsp;This requires your
              application to request the following permission in your manifest: <code>&lt;uses-permission
              id=&quot;android.permission.CALL_PHONE&quot; /&gt;</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>&amp;cbp=1,<em>yaw</em>,,<em>pitch</em>,<em>zoom</em>&amp;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>