1page.title=從應用行為顯示取得結果
2page.tags=意圖
3helpoutsWidget=true
4
5trainingnavtop=true
6
7@jd:body
8
9<div id="tb-wrapper">
10  <div id="tb">
11
12<h2>本課程示範</h2>
13<ol>
14  <li><a href="#StartActivity">啟動應用行為顯示</a></li>
15  <li><a href="#ReceiveResult">接收結果</a></li>
16</ol>
17
18<h2>您也應該閱讀</h2>
19<ul>
20    <li><a href="{@docRoot}training/sharing/index.html">共用簡單資料</a></li>
21    <li><a href="{@docRoot}training/secure-file-sharing/index.html">共用檔案</a>
22</ul>
23
24  </div>
25</div>
26
27<p>啟動其他應用行為顯示不必是單向作業。您也可以啟動其他應用行為顯示，然後接收傳回的結果。
28若要接收結果，請呼叫 {@link android.app.Activity#startActivityForResult
29startActivityForResult()} (而非 {@link android.app.Activity#startActivity
30startActivity()})。</p>
31
32<p>例如，您的應用程式可以啟動相機應用程式，然後接收所拍攝的相片作為結果。或者，您可以啟動人員應用程式 (以便讓使用者選取連絡人)，然後接收作為結果的連絡人詳細資料。
33
34</p>
35
36<p>當然，必須將提供回應的應用行為顯示設計為傳回結果。執行時，該應用行為顯示會以其他 {@link android.content.Intent} 物件的形式傳送結果。
37您的應用行為顯示會在 {@link android.app.Activity#onActivityResult onActivityResult()} 回呼中接收該結果。
38</p>
39
40<p class="note"><strong>注意：</strong>呼叫 {@link android.app.Activity#startActivityForResult startActivityForResult()} 時，您可以使用明確或隱含的意圖。
41啟動您的其中一個應用行為顯示以接收結果時，您應使用明確的意圖，以確保收到預期結果。
42
43</p>
44
45
46<h2 id="StartActivity">啟動應用行為顯示</h2>
47
48<p>啟動應用行為顯示以接收結果時，您使用的 {@link android.content.Intent} 物件沒有任何特殊之處，但是您需要將附加整數引數傳遞至 {@link
49android.app.Activity#startActivityForResult startActivityForResult()} 方法。
50</p>
51
52<p>該整數引數是識別您要求的「要求代碼」。在您接收結果 {@link android.content.Intent} 時，回呼會提供同一要求代碼，以便您的應用程式可以正確識別結果並判斷如何處理結果。
53
54</p>
55
56<p>例如，以下展示了如何啟動應用行為顯示 (使用者可藉此挑選連絡人)：</p>
57
58<pre>
59static final int PICK_CONTACT_REQUEST = 1;  // The request code
60...
61private void pickContact() {
62    Intent pickContactIntent = new Intent(Intent.ACTION_PICK, Uri.parse("content://contacts"));
63    pickContactIntent.setType(Phone.CONTENT_TYPE); // Show user only contacts w/ phone numbers
64    startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);
65}
66</pre>
67
68
69<h2 id="ReceiveResult">接收結果</h2>
70
71<p>使用者處理隨後的應用行為顯示並返回時，系統會呼叫應用行為顯示的 {@link android.app.Activity#onActivityResult onActivityResult()} 方法。
72此方法包括三個引數：
73</p>
74
75<ul>
76  <li>您傳遞至 {@link
77android.app.Activity#startActivityForResult startActivityForResult()} 的要求代碼。</li>
78  <li>由第二個應用行為顯示指定的結果代碼。此代碼是 {@link
79android.app.Activity#RESULT_OK} (若操作成功) 或 {@link
80android.app.Activity#RESULT_CANCELED} (若因故使用者退出或操作失敗)。
81</li>
82  <li>攜帶結果資料的 {@link android.content.Intent}。</li>
83</ul>
84
85<p>例如，以下為您展示了如何處理「挑選連絡人」意圖的結果：</p>
86
87<pre>
88&#64;Override
89protected void onActivityResult(int requestCode, int resultCode, Intent data) {
90    // Check which request we're responding to
91    if (requestCode == PICK_CONTACT_REQUEST) {
92        // Make sure the request was successful
93        if (resultCode == RESULT_OK) {
94            // The user picked a contact.
95            // The Intent's data Uri identifies which contact was selected.
96
97            // Do something with the contact here (bigger example below)
98        }
99    }
100}
101</pre>
102
103<p>在此範例中，由 Android 的連絡人或人員應用程式傳回的結果 {@link android.content.Intent} 可提供內容 {@link android.net.Uri} (能識別使用者所選取的連絡人)。
104
105</p>
106
107<p>若要成功處理結果，您必須了解結果 {@link android.content.Intent} 將採用的格式。
108若傳回結果的應用行為顯示是您的其中一個應用行為顯示，上述作業會非常簡單。
109Android 平台隨附的應用程式會針對特定結果資料提供您可以依賴的 API。
110例如，人員應用程式 (某些舊版上的連絡人應用程式) 會始終傳回含內容 URI (可識別選取的連絡人) 的結果，相機應用程式會在 {@code "data"} 額外項目中傳回 {@link android.graphics.Bitmap} (請參閱有關<a href="{@docRoot}training/camera/index.html">拍攝相片</a>的課程)。
111
112
113</p>
114
115
116<h4>額外說明：讀取連絡人資料</h4>
117
118<p>上述程式碼展示如何從人員應用程式取得結果，並未詳述如何實際讀取結果的資料，因為這需要進行更高級的
119<a href="{@docRoot}guide/topics/providers/content-providers.html">內容提供者</a>相關討論。
120
121但是，若您對此感到好奇，以下提供了另外一些程式碼，這些程式碼會展示如何查詢結果資料，以便取得所選連絡人的電話號碼：
122</p>
123
124<pre>
125&#64;Override
126protected void onActivityResult(int requestCode, int resultCode, Intent data) {
127    // Check which request it is that we're responding to
128    if (requestCode == PICK_CONTACT_REQUEST) {
129        // Make sure the request was successful
130        if (resultCode == RESULT_OK) {
131            // Get the URI that points to the selected contact
132            Uri contactUri = data.getData();
133            // We only need the NUMBER column, because there will be only one row in the result
134            String[] projection = {Phone.NUMBER};
135
136            // Perform the query on the contact to get the NUMBER column
137            // We don't need a selection or sort order (there's only one result for the given URI)
138            // CAUTION: The query() method should be called from a separate thread to avoid blocking
139            // your app's UI thread. (For simplicity of the sample, this code doesn't do that.)
140            // Consider using {@link android.content.CursorLoader} to perform the query.
141            Cursor cursor = getContentResolver()
142                    .query(contactUri, projection, null, null, null);
143            cursor.moveToFirst();
144
145            // Retrieve the phone number from the NUMBER column
146            int column = cursor.getColumnIndex(Phone.NUMBER);
147            String number = cursor.getString(column);
148
149            // Do something with the phone number...
150        }
151    }
152}
153</pre>
154
155<p class="note"><strong>注意：</strong>在 Android 2.3 (API 級別為 9) 版之前，若在 {@link android.provider.ContactsContract.Contacts Contacts Provider} (例如以上所示) 上執行查詢，需要您的應用程式宣告 {@link
156android.Manifest.permission#READ_CONTACTS} 權限 (請參閱<a href="{@docRoot}guide/topics/security/security.html">安全性與權限</a>)。
157
158但是，從 Android 2.3 版開始，在連絡人提供者傳回結果時，連絡人/人員應用程式會為您的應用程式授予讀取連絡人提供者的臨時權限。
159
160該臨時權限僅適用於要求的特定連絡人，因此除非您已宣告 {@link
161android.Manifest.permission#READ_CONTACTS} 權限，否則無法查詢並非由意圖的 {@link android.net.Uri} 指定的連絡人。
162
163</p>
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179