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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
page.title=Получение результата операции
page.tags=объекты Intent
helpoutsWidget=true
trainingnavtop=true
@jd:body
<div id="tb-wrapper">
<div id="tb">
<h2>Содержание этого урока</h2>
<ol>
<li><a href="#StartActivity">Запуск операции</a></li>
<li><a href="#ReceiveResult">Получение результата</a></li>
</ol>
<h2>См. также:</h2>
<ul>
<li><a href="{@docRoot}training/sharing/index.html">Общий доступ к простым данным</a></li>
<li><a href="{@docRoot}training/secure-file-sharing/index.html">Общий доступ к файлам</a>
</ul>
</div>
</div>
<p>Запуск другой операции не обязательно должен быть односторонним действием. Вы можете запустить другую операцию и
получить от нее результат. Для получения результата нужно вызвать метод {@link android.app.Activity#startActivityForResult
startActivityForResult()} (вместо {@link android.app.Activity#startActivity
startActivity()}).</p>
<p>Например, ваше приложение может запустить приложение для камеры и получить в качестве результата фотографию. Также вы
можете запустить приложение "Люди", чтобы пользователь выбрал в нем
контакт, и получить контактные данные в качестве результата.</p>
<p>Разумеется, отвечающая операция должна быть способной возвратить результат. При возврате
результат отправляется как другой объект {@link android.content.Intent}. Ваша операция получает
его в обратном вызове {@link android.app.Activity#onActivityResult onActivityResult()}.</p>
<p class="note"><strong>Примечание.</strong> Вы можете использовать явные и неявные результаты при вызове
{@link android.app.Activity#startActivityForResult startActivityForResult()}. При запуске собственной
операции для получения результата вы должны использовать явные результаты, чтобы получить
именно ожидаемый результат.</p>
<h2 id="StartActivity">Запуск операции</h2>
<p>В объекте {@link android.content.Intent}, используемом для запуска операции
для получения результата, нет ничего особенного, однако нужно передать дополнительный целочисленный аргумент методы {@link
android.app.Activity#startActivityForResult startActivityForResult()}.</p>
<p>Этот целочисленный аргумент представляет собой "код запроса", определяющий ваш запрос. Когда вы получите
результат {@link android.content.Intent}, обратный вызов использует тот же самый код результата,
чтобы ваше приложение могло правильно определить результат и понять, как его нужно обработать.</p>
<p>Например, вот так можно запустить операцию, позволяющую пользователю выбрать контакт:</p>
<pre>
static final int PICK_CONTACT_REQUEST = 1; // The request code
...
private void pickContact() {
Intent pickContactIntent = new Intent(Intent.ACTION_PICK, Uri.parse("content://contacts"));
pickContactIntent.setType(Phone.CONTENT_TYPE); // Show user only contacts w/ phone numbers
startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);
}
</pre>
<h2 id="ReceiveResult">Получение результата</h2>
<p>Когда пользователь завершит последующую операцию и вернется, система вызовет метод вашей операции
{@link android.app.Activity#onActivityResult onActivityResult()}. Этот метод содержит три
аргумента:</p>
<ul>
<li>Код запроса, переданный вами {@link
android.app.Activity#startActivityForResult startActivityForResult()}.</li>
<li>Полученный в качестве результата код, указанный второй операцией. Или {@link
android.app.Activity#RESULT_OK}, если операция была успешной, или {@link
android.app.Activity#RESULT_CANCELED}, если пользователь отказался или операцию не удалось выполнить по какой-либо
причине.</li>
<li>{@link android.content.Intent}, переносящий полученные данные.</li>
</ul>
<p>Например, результаты для намерения "Выбрать контакт" могут обрабатываться следующим образом:</p>
<pre>
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// The user picked a contact.
// The Intent's data Uri identifies which contact was selected.
// Do something with the contact here (bigger example below)
}
}
}
</pre>
<p>В этом примере результаты, {@link android.content.Intent} возвращаемые приложениями
Android Контакты или Люди, предоставляют контент {@link android.net.Uri}, который идентифицирует
выбранный пользователем контакт.</p>
<p>Для успешной обработки результатов необходимо понимать, каким будет формат этих результатов
{@link android.content.Intent}. Это просто, если результат возвращается одной из ваших
собственных операций. Приложения, входящие в состав платформы Android, имеют собственные прикладные интерфейсы, так что
вы можете рассчитывать на получение определенных результатов. Например, приложение "Люди" (приложение "Контакты" в старых
версиях) всегда возвращает результат с URI контента, идентифицирующий выбранный контакт, а приложение
"Камера" возвращает {@link android.graphics.Bitmap} в дополнительном {@code "data"} (см. урок
<a href="{@docRoot}training/camera/index.html">Съемка фотографий</a>).</p>
<h4>Бонус: Чтение контактных данных</h4>
<p>Приведенный выше код, показывающий как получить результаты из приложения "Люди", не описывает
детально чтение данных результатов, потому что для этого нужно более
подробно рассказать о <a href="{@docRoot}guide/topics/providers/content-providers.html">поставщиках
контента</a>. Если вам все-таки интересно, вот еще код, показывающий как запрашивать
данные результатов для получения номера телефона выбранного контакта:</p>
<pre>
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request it is that we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// Get the URI that points to the selected contact
Uri contactUri = data.getData();
// We only need the NUMBER column, because there will be only one row in the result
String[] projection = {Phone.NUMBER};
// Perform the query on the contact to get the NUMBER column
// We don't need a selection or sort order (there's only one result for the given URI)
// CAUTION: The query() method should be called from a separate thread to avoid blocking
// your app's UI thread. (For simplicity of the sample, this code doesn't do that.)
// Consider using {@link android.content.CursorLoader} to perform the query.
Cursor cursor = getContentResolver()
.query(contactUri, projection, null, null, null);
cursor.moveToFirst();
// Retrieve the phone number from the NUMBER column
int column = cursor.getColumnIndex(Phone.NUMBER);
String number = cursor.getString(column);
// Do something with the phone number...
}
}
}
</pre>
<p class="note"><strong>Примечание.</strong> До выхода версии Android 2.3 (API-интерфейс уровня 9) для выполнения
запроса {@link android.provider.ContactsContract.Contacts Contacts Provider} (как
показанный выше) ваше приложение должно было декларировать разрешение {@link
android.Manifest.permission#READ_CONTACTS} (см. <a href="{@docRoot}guide/topics/security/security.html">Безопасность и разрешения</a>). Однако,
начиная с версии Android 2.3, приложение "Контакты/Люди" дает вашему приложению временное
разрешение на чтение данных Поставщика контактов при выводе результата. Это временное разрешение
действует только в отношении конкретного запрошенного контакта, так что нельзя запрашивать другой контакт,
кроме указанного объектом Intent {@link android.net.Uri}, если вы не хотите декларировать разрешение {@link
android.Manifest.permission#READ_CONTACTS}.</p>
|
