blob: 65babc2dea9bc10ab12e6041c06509cd4134e3c6 [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/*
2 * Copyright (C) 2006 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.provider;
18
satok8969d992011-06-22 16:41:58 +090019
20
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080021import android.annotation.SdkConstant;
22import android.annotation.SdkConstant.SdkConstantType;
Narayan Kamathee69ff42011-06-28 12:07:18 +010023import android.app.SearchManager;
Mike LeBeau5d34e9b2010-02-10 19:34:56 -080024import android.content.ComponentName;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080025import android.content.ContentResolver;
26import android.content.ContentValues;
27import android.content.Context;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -080028import android.content.IContentProvider;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080029import android.content.Intent;
Dianne Hackbornb8b11a02010-03-10 15:53:11 -080030import android.content.pm.ActivityInfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080031import android.content.pm.PackageManager;
32import android.content.pm.ResolveInfo;
33import android.content.res.Configuration;
34import android.content.res.Resources;
35import android.database.Cursor;
36import android.database.SQLException;
37import android.net.Uri;
Irfan Sheriff36f74132010-11-04 16:57:37 -070038import android.net.wifi.WifiManager;
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -070039import android.os.BatteryManager;
40import android.os.Bundle;
41import android.os.RemoteException;
42import android.os.SystemProperties;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080043import android.text.TextUtils;
44import android.util.AndroidException;
45import android.util.Log;
46
47import java.net.URISyntaxException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080048import java.util.HashMap;
49import java.util.HashSet;
50
satok8969d992011-06-22 16:41:58 +090051
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080052/**
53 * The Settings provider contains global system-level device preferences.
54 */
55public final class Settings {
56
57 // Intent actions for Settings
58
59 /**
60 * Activity Action: Show system settings.
61 * <p>
62 * Input: Nothing.
63 * <p>
64 * Output: nothing.
65 */
66 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
67 public static final String ACTION_SETTINGS = "android.settings.SETTINGS";
68
69 /**
70 * Activity Action: Show settings to allow configuration of APNs.
71 * <p>
72 * Input: Nothing.
73 * <p>
74 * Output: nothing.
75 */
76 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
77 public static final String ACTION_APN_SETTINGS = "android.settings.APN_SETTINGS";
78
79 /**
80 * Activity Action: Show settings to allow configuration of current location
81 * sources.
82 * <p>
83 * In some cases, a matching Activity may not exist, so ensure you
84 * safeguard against this.
85 * <p>
86 * Input: Nothing.
87 * <p>
88 * Output: Nothing.
89 */
90 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
91 public static final String ACTION_LOCATION_SOURCE_SETTINGS =
92 "android.settings.LOCATION_SOURCE_SETTINGS";
93
94 /**
95 * Activity Action: Show settings to allow configuration of wireless controls
96 * such as Wi-Fi, Bluetooth and Mobile networks.
97 * <p>
98 * In some cases, a matching Activity may not exist, so ensure you
99 * safeguard against this.
100 * <p>
101 * Input: Nothing.
102 * <p>
103 * Output: Nothing.
104 */
105 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
106 public static final String ACTION_WIRELESS_SETTINGS =
107 "android.settings.WIRELESS_SETTINGS";
108
109 /**
110 * Activity Action: Show settings to allow entering/exiting airplane mode.
111 * <p>
112 * In some cases, a matching Activity may not exist, so ensure you
113 * safeguard against this.
114 * <p>
115 * Input: Nothing.
116 * <p>
117 * Output: Nothing.
118 */
119 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
120 public static final String ACTION_AIRPLANE_MODE_SETTINGS =
121 "android.settings.AIRPLANE_MODE_SETTINGS";
122
123 /**
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700124 * Activity Action: Show settings for accessibility modules.
125 * <p>
126 * In some cases, a matching Activity may not exist, so ensure you
127 * safeguard against this.
128 * <p>
129 * Input: Nothing.
130 * <p>
131 * Output: Nothing.
132 */
133 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
134 public static final String ACTION_ACCESSIBILITY_SETTINGS =
135 "android.settings.ACCESSIBILITY_SETTINGS";
136
137 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800138 * Activity Action: Show settings to allow configuration of security and
139 * location privacy.
140 * <p>
141 * In some cases, a matching Activity may not exist, so ensure you
142 * safeguard against this.
143 * <p>
144 * Input: Nothing.
145 * <p>
146 * Output: Nothing.
147 */
148 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
149 public static final String ACTION_SECURITY_SETTINGS =
150 "android.settings.SECURITY_SETTINGS";
151
152 /**
Amith Yamasanic15255a2009-09-23 15:33:19 -0700153 * Activity Action: Show settings to allow configuration of privacy options.
154 * <p>
155 * In some cases, a matching Activity may not exist, so ensure you
156 * safeguard against this.
157 * <p>
158 * Input: Nothing.
159 * <p>
160 * Output: Nothing.
161 */
162 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
163 public static final String ACTION_PRIVACY_SETTINGS =
164 "android.settings.PRIVACY_SETTINGS";
165
166 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800167 * Activity Action: Show settings to allow configuration of Wi-Fi.
168
169 * <p>
170 * In some cases, a matching Activity may not exist, so ensure you
171 * safeguard against this.
172 * <p>
173 * Input: Nothing.
174 * <p>
175 * Output: Nothing.
176
177 */
178 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
179 public static final String ACTION_WIFI_SETTINGS =
180 "android.settings.WIFI_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700181
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800182 /**
183 * Activity Action: Show settings to allow configuration of a static IP
184 * address for Wi-Fi.
185 * <p>
186 * In some cases, a matching Activity may not exist, so ensure you safeguard
187 * against this.
188 * <p>
189 * Input: Nothing.
190 * <p>
191 * Output: Nothing.
192 */
193 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
194 public static final String ACTION_WIFI_IP_SETTINGS =
195 "android.settings.WIFI_IP_SETTINGS";
196
197 /**
198 * Activity Action: Show settings to allow configuration of Bluetooth.
199 * <p>
200 * In some cases, a matching Activity may not exist, so ensure you
201 * safeguard against this.
202 * <p>
203 * Input: Nothing.
204 * <p>
205 * Output: Nothing.
206 */
207 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
208 public static final String ACTION_BLUETOOTH_SETTINGS =
209 "android.settings.BLUETOOTH_SETTINGS";
210
211 /**
212 * Activity Action: Show settings to allow configuration of date and time.
213 * <p>
214 * In some cases, a matching Activity may not exist, so ensure you
215 * safeguard against this.
216 * <p>
217 * Input: Nothing.
218 * <p>
219 * Output: Nothing.
220 */
221 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
222 public static final String ACTION_DATE_SETTINGS =
223 "android.settings.DATE_SETTINGS";
224
225 /**
226 * Activity Action: Show settings to allow configuration of sound and volume.
227 * <p>
228 * In some cases, a matching Activity may not exist, so ensure you
229 * safeguard against this.
230 * <p>
231 * Input: Nothing.
232 * <p>
233 * Output: Nothing.
234 */
235 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
236 public static final String ACTION_SOUND_SETTINGS =
237 "android.settings.SOUND_SETTINGS";
238
239 /**
240 * Activity Action: Show settings to allow configuration of display.
241 * <p>
242 * In some cases, a matching Activity may not exist, so ensure you
243 * safeguard against this.
244 * <p>
245 * Input: Nothing.
246 * <p>
247 * Output: Nothing.
248 */
249 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
250 public static final String ACTION_DISPLAY_SETTINGS =
251 "android.settings.DISPLAY_SETTINGS";
252
253 /**
254 * Activity Action: Show settings to allow configuration of locale.
255 * <p>
256 * In some cases, a matching Activity may not exist, so ensure you
257 * safeguard against this.
258 * <p>
259 * Input: Nothing.
260 * <p>
261 * Output: Nothing.
262 */
263 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
264 public static final String ACTION_LOCALE_SETTINGS =
265 "android.settings.LOCALE_SETTINGS";
266
267 /**
268 * Activity Action: Show settings to configure input methods, in particular
269 * allowing the user to enable input methods.
270 * <p>
271 * In some cases, a matching Activity may not exist, so ensure you
272 * safeguard against this.
273 * <p>
274 * Input: Nothing.
275 * <p>
276 * Output: Nothing.
277 */
278 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
279 public static final String ACTION_INPUT_METHOD_SETTINGS =
280 "android.settings.INPUT_METHOD_SETTINGS";
281
282 /**
Tadashi G. Takaokaf49688f2011-01-20 17:56:13 +0900283 * Activity Action: Show settings to enable/disable input method subtypes.
satok86417ea2010-10-27 14:11:03 +0900284 * <p>
285 * In some cases, a matching Activity may not exist, so ensure you
286 * safeguard against this.
287 * <p>
Tadashi G. Takaoka25480202011-01-20 23:13:02 +0900288 * To tell which input method's subtypes are displayed in the settings, add
289 * {@link #EXTRA_INPUT_METHOD_ID} extra to this Intent with the input method id.
290 * If there is no extra in this Intent, subtypes from all installed input methods
291 * will be displayed in the settings.
292 *
293 * @see android.view.inputmethod.InputMethodInfo#getId
294 * <p>
satok86417ea2010-10-27 14:11:03 +0900295 * Input: Nothing.
296 * <p>
297 * Output: Nothing.
298 */
299 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
Tadashi G. Takaokaf49688f2011-01-20 17:56:13 +0900300 public static final String ACTION_INPUT_METHOD_SUBTYPE_SETTINGS =
301 "android.settings.INPUT_METHOD_SUBTYPE_SETTINGS";
satok86417ea2010-10-27 14:11:03 +0900302
303 /**
satok7cfc0ed2011-06-20 21:29:36 +0900304 * Activity Action: Show a dialog to select input method.
305 * <p>
306 * In some cases, a matching Activity may not exist, so ensure you
307 * safeguard against this.
308 * <p>
309 * Input: Nothing.
310 * <p>
311 * Output: Nothing.
312 * @hide
313 */
314 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
315 public static final String ACTION_SHOW_INPUT_METHOD_PICKER =
316 "android.settings.SHOW_INPUT_METHOD_PICKER";
317
318 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800319 * Activity Action: Show settings to manage the user input dictionary.
320 * <p>
321 * In some cases, a matching Activity may not exist, so ensure you
322 * safeguard against this.
323 * <p>
324 * Input: Nothing.
325 * <p>
326 * Output: Nothing.
327 */
328 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
329 public static final String ACTION_USER_DICTIONARY_SETTINGS =
330 "android.settings.USER_DICTIONARY_SETTINGS";
331
332 /**
333 * Activity Action: Show settings to allow configuration of application-related settings.
334 * <p>
335 * In some cases, a matching Activity may not exist, so ensure you
336 * safeguard against this.
337 * <p>
338 * Input: Nothing.
339 * <p>
340 * Output: Nothing.
341 */
342 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
343 public static final String ACTION_APPLICATION_SETTINGS =
344 "android.settings.APPLICATION_SETTINGS";
345
346 /**
347 * Activity Action: Show settings to allow configuration of application
348 * development-related settings.
349 * <p>
350 * In some cases, a matching Activity may not exist, so ensure you safeguard
351 * against this.
352 * <p>
353 * Input: Nothing.
354 * <p>
355 * Output: Nothing.
356 */
357 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
358 public static final String ACTION_APPLICATION_DEVELOPMENT_SETTINGS =
359 "android.settings.APPLICATION_DEVELOPMENT_SETTINGS";
360
361 /**
362 * Activity Action: Show settings to allow configuration of quick launch shortcuts.
363 * <p>
364 * In some cases, a matching Activity may not exist, so ensure you
365 * safeguard against this.
366 * <p>
367 * Input: Nothing.
368 * <p>
369 * Output: Nothing.
370 */
371 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
372 public static final String ACTION_QUICK_LAUNCH_SETTINGS =
373 "android.settings.QUICK_LAUNCH_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700374
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800375 /**
376 * Activity Action: Show settings to manage installed applications.
377 * <p>
378 * In some cases, a matching Activity may not exist, so ensure you
379 * safeguard against this.
380 * <p>
381 * Input: Nothing.
382 * <p>
383 * Output: Nothing.
384 */
385 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
386 public static final String ACTION_MANAGE_APPLICATIONS_SETTINGS =
387 "android.settings.MANAGE_APPLICATIONS_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700388
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800389 /**
Winson Chung44e8ff92010-09-27 14:36:52 -0700390 * Activity Action: Show settings to manage all applications.
391 * <p>
392 * In some cases, a matching Activity may not exist, so ensure you
393 * safeguard against this.
394 * <p>
395 * Input: Nothing.
396 * <p>
397 * Output: Nothing.
398 */
399 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
400 public static final String ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS =
401 "android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS";
402
403 /**
Dianne Hackbornb7bb3b32010-06-06 22:47:50 -0700404 * Activity Action: Show screen of details about a particular application.
405 * <p>
406 * In some cases, a matching Activity may not exist, so ensure you
407 * safeguard against this.
408 * <p>
409 * Input: The Intent's data URI specifies the application package name
410 * to be shown, with the "package" scheme. That is "package:com.my.app".
411 * <p>
412 * Output: Nothing.
413 */
414 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
415 public static final String ACTION_APPLICATION_DETAILS_SETTINGS =
416 "android.settings.APPLICATION_DETAILS_SETTINGS";
417
418 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800419 * Activity Action: Show settings for system update functionality.
420 * <p>
421 * In some cases, a matching Activity may not exist, so ensure you
422 * safeguard against this.
423 * <p>
424 * Input: Nothing.
425 * <p>
426 * Output: Nothing.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700427 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800428 * @hide
429 */
430 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
431 public static final String ACTION_SYSTEM_UPDATE_SETTINGS =
432 "android.settings.SYSTEM_UPDATE_SETTINGS";
433
434 /**
435 * Activity Action: Show settings to allow configuration of sync settings.
436 * <p>
437 * In some cases, a matching Activity may not exist, so ensure you
438 * safeguard against this.
439 * <p>
Erikeebc8e22010-02-18 13:27:19 -0800440 * The account types available to add via the add account button may be restricted by adding an
441 * {@link #EXTRA_AUTHORITIES} extra to this Intent with one or more syncable content provider's
442 * authorities. Only account types which can sync with that content provider will be offered to
443 * the user.
444 * <p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800445 * Input: Nothing.
446 * <p>
447 * Output: Nothing.
448 */
449 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
450 public static final String ACTION_SYNC_SETTINGS =
451 "android.settings.SYNC_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700452
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800453 /**
Erikeebc8e22010-02-18 13:27:19 -0800454 * Activity Action: Show add account screen for creating a new account.
455 * <p>
456 * In some cases, a matching Activity may not exist, so ensure you
457 * safeguard against this.
458 * <p>
459 * The account types available to add may be restricted by adding an {@link #EXTRA_AUTHORITIES}
460 * extra to the Intent with one or more syncable content provider's authorities. Only account
461 * types which can sync with that content provider will be offered to the user.
462 * <p>
463 * Input: Nothing.
464 * <p>
465 * Output: Nothing.
466 */
467 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
468 public static final String ACTION_ADD_ACCOUNT =
469 "android.settings.ADD_ACCOUNT_SETTINGS";
470
471 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800472 * Activity Action: Show settings for selecting the network operator.
473 * <p>
474 * In some cases, a matching Activity may not exist, so ensure you
475 * safeguard against this.
476 * <p>
477 * Input: Nothing.
478 * <p>
479 * Output: Nothing.
480 */
481 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
482 public static final String ACTION_NETWORK_OPERATOR_SETTINGS =
483 "android.settings.NETWORK_OPERATOR_SETTINGS";
484
485 /**
486 * Activity Action: Show settings for selection of 2G/3G.
487 * <p>
488 * In some cases, a matching Activity may not exist, so ensure you
489 * safeguard against this.
490 * <p>
491 * Input: Nothing.
492 * <p>
493 * Output: Nothing.
494 */
495 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
496 public static final String ACTION_DATA_ROAMING_SETTINGS =
497 "android.settings.DATA_ROAMING_SETTINGS";
498
499 /**
500 * Activity Action: Show settings for internal storage.
501 * <p>
502 * In some cases, a matching Activity may not exist, so ensure you
503 * safeguard against this.
504 * <p>
505 * Input: Nothing.
506 * <p>
507 * Output: Nothing.
508 */
509 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
510 public static final String ACTION_INTERNAL_STORAGE_SETTINGS =
511 "android.settings.INTERNAL_STORAGE_SETTINGS";
512 /**
513 * Activity Action: Show settings for memory card storage.
514 * <p>
515 * In some cases, a matching Activity may not exist, so ensure you
516 * safeguard against this.
517 * <p>
518 * Input: Nothing.
519 * <p>
520 * Output: Nothing.
521 */
522 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
523 public static final String ACTION_MEMORY_CARD_SETTINGS =
524 "android.settings.MEMORY_CARD_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700525
Justin Mattsonef340352010-01-13 21:05:46 -0800526 /**
527 * Activity Action: Show settings for global search.
528 * <p>
529 * In some cases, a matching Activity may not exist, so ensure you
530 * safeguard against this.
531 * <p>
532 * Input: Nothing.
533 * <p>
534 * Output: Nothing
535 */
536 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
537 public static final String ACTION_SEARCH_SETTINGS =
538 "android.search.action.SEARCH_SETTINGS";
539
Daniel Sandler9d8b8762010-01-22 20:50:15 -0500540 /**
541 * Activity Action: Show general device information settings (serial
542 * number, software version, phone number, etc.).
543 * <p>
544 * In some cases, a matching Activity may not exist, so ensure you
545 * safeguard against this.
546 * <p>
547 * Input: Nothing.
548 * <p>
549 * Output: Nothing
550 */
551 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
552 public static final String ACTION_DEVICE_INFO_SETTINGS =
553 "android.settings.DEVICE_INFO_SETTINGS";
554
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800555 // End of Intent actions for Settings
556
Erikeebc8e22010-02-18 13:27:19 -0800557 /**
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800558 * @hide - Private call() method on SettingsProvider to read from 'system' table.
559 */
560 public static final String CALL_METHOD_GET_SYSTEM = "GET_system";
561
562 /**
563 * @hide - Private call() method on SettingsProvider to read from 'secure' table.
564 */
565 public static final String CALL_METHOD_GET_SECURE = "GET_secure";
566
567 /**
Erikeebc8e22010-02-18 13:27:19 -0800568 * Activity Extra: Limit available options in launched activity based on the given authority.
569 * <p>
570 * This can be passed as an extra field in an Activity Intent with one or more syncable content
571 * provider's authorities as a String[]. This field is used by some intents to alter the
572 * behavior of the called activity.
573 * <p>
574 * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types available based
575 * on the authority given.
576 */
577 public static final String EXTRA_AUTHORITIES =
578 "authorities";
579
Tadashi G. Takaoka25480202011-01-20 23:13:02 +0900580 public static final String EXTRA_INPUT_METHOD_ID = "input_method_id";
581
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800582 private static final String JID_RESOURCE_PREFIX = "android";
583
584 public static final String AUTHORITY = "settings";
585
586 private static final String TAG = "Settings";
Joe Onorato43a17652011-04-06 19:22:23 -0700587 private static final boolean LOCAL_LOGV = false || false;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800588
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800589 public static class SettingNotFoundException extends AndroidException {
590 public SettingNotFoundException(String msg) {
591 super(msg);
592 }
593 }
594
595 /**
596 * Common base for tables of name/value settings.
597 */
598 public static class NameValueTable implements BaseColumns {
599 public static final String NAME = "name";
600 public static final String VALUE = "value";
601
602 protected static boolean putString(ContentResolver resolver, Uri uri,
603 String name, String value) {
604 // The database will take care of replacing duplicates.
605 try {
606 ContentValues values = new ContentValues();
607 values.put(NAME, name);
608 values.put(VALUE, value);
609 resolver.insert(uri, values);
610 return true;
611 } catch (SQLException e) {
Dianne Hackborna33e3f72009-09-29 17:28:24 -0700612 Log.w(TAG, "Can't set key " + name + " in " + uri, e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800613 return false;
614 }
615 }
616
617 public static Uri getUriFor(Uri uri, String name) {
618 return Uri.withAppendedPath(uri, name);
619 }
620 }
621
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800622 // Thread-safe.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800623 private static class NameValueCache {
624 private final String mVersionSystemProperty;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800625 private final Uri mUri;
626
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800627 private static final String[] SELECT_VALUE =
628 new String[] { Settings.NameValueTable.VALUE };
629 private static final String NAME_EQ_PLACEHOLDER = "name=?";
630
631 // Must synchronize on 'this' to access mValues and mValuesVersion.
Dan Egnor799f7212009-11-24 16:24:44 -0800632 private final HashMap<String, String> mValues = new HashMap<String, String>();
633 private long mValuesVersion = 0;
634
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800635 // Initially null; set lazily and held forever. Synchronized on 'this'.
636 private IContentProvider mContentProvider = null;
637
638 // The method we'll call (or null, to not use) on the provider
639 // for the fast path of retrieving settings.
640 private final String mCallCommand;
641
642 public NameValueCache(String versionSystemProperty, Uri uri, String callCommand) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800643 mVersionSystemProperty = versionSystemProperty;
644 mUri = uri;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800645 mCallCommand = callCommand;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800646 }
647
Dan Egnor799f7212009-11-24 16:24:44 -0800648 public String getString(ContentResolver cr, String name) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800649 long newValuesVersion = SystemProperties.getLong(mVersionSystemProperty, 0);
Dan Egnor799f7212009-11-24 16:24:44 -0800650
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800651 synchronized (this) {
Dan Egnor799f7212009-11-24 16:24:44 -0800652 if (mValuesVersion != newValuesVersion) {
653 if (LOCAL_LOGV) {
654 Log.v(TAG, "invalidate [" + mUri.getLastPathSegment() + "]: current " +
655 newValuesVersion + " != cached " + mValuesVersion);
656 }
657
658 mValues.clear();
659 mValuesVersion = newValuesVersion;
660 }
661
662 if (mValues.containsKey(name)) {
663 return mValues.get(name); // Could be null, that's OK -- negative caching
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800664 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800665 }
Dan Egnor799f7212009-11-24 16:24:44 -0800666
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800667 IContentProvider cp = null;
668 synchronized (this) {
669 cp = mContentProvider;
670 if (cp == null) {
671 cp = mContentProvider = cr.acquireProvider(mUri.getAuthority());
672 }
673 }
674
675 // Try the fast path first, not using query(). If this
676 // fails (alternate Settings provider that doesn't support
677 // this interface?) then we fall back to the query/table
678 // interface.
679 if (mCallCommand != null) {
680 try {
681 Bundle b = cp.call(mCallCommand, name, null);
682 if (b != null) {
683 String value = b.getPairValue();
684 synchronized (this) {
685 mValues.put(name, value);
686 }
687 return value;
688 }
689 // If the response Bundle is null, we fall through
690 // to the query interface below.
691 } catch (RemoteException e) {
692 // Not supported by the remote side? Fall through
693 // to query().
694 }
695 }
696
Dan Egnor799f7212009-11-24 16:24:44 -0800697 Cursor c = null;
698 try {
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800699 c = cp.query(mUri, SELECT_VALUE, NAME_EQ_PLACEHOLDER,
700 new String[]{name}, null);
Dan Egnor799f7212009-11-24 16:24:44 -0800701 if (c == null) {
702 Log.w(TAG, "Can't get key " + name + " from " + mUri);
703 return null;
704 }
705
706 String value = c.moveToNext() ? c.getString(0) : null;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800707 synchronized (this) {
Dan Egnor799f7212009-11-24 16:24:44 -0800708 mValues.put(name, value);
709 }
710 if (LOCAL_LOGV) {
711 Log.v(TAG, "cache miss [" + mUri.getLastPathSegment() + "]: " +
712 name + " = " + (value == null ? "(null)" : value));
713 }
714 return value;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800715 } catch (RemoteException e) {
Dan Egnor799f7212009-11-24 16:24:44 -0800716 Log.w(TAG, "Can't get key " + name + " from " + mUri, e);
717 return null; // Return null, but don't cache it.
718 } finally {
719 if (c != null) c.close();
720 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800721 }
722 }
723
724 /**
725 * System settings, containing miscellaneous system preferences. This
726 * table holds simple name/value pairs. There are convenience
727 * functions for accessing individual settings entries.
728 */
729 public static final class System extends NameValueTable {
730 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_system_version";
731
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800732 // Populated lazily, guarded by class object:
733 private static NameValueCache sNameValueCache = null;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700734
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800735 private static final HashSet<String> MOVED_TO_SECURE;
736 static {
737 MOVED_TO_SECURE = new HashSet<String>(30);
738 MOVED_TO_SECURE.add(Secure.ADB_ENABLED);
739 MOVED_TO_SECURE.add(Secure.ANDROID_ID);
740 MOVED_TO_SECURE.add(Secure.BLUETOOTH_ON);
741 MOVED_TO_SECURE.add(Secure.DATA_ROAMING);
742 MOVED_TO_SECURE.add(Secure.DEVICE_PROVISIONED);
743 MOVED_TO_SECURE.add(Secure.HTTP_PROXY);
744 MOVED_TO_SECURE.add(Secure.INSTALL_NON_MARKET_APPS);
745 MOVED_TO_SECURE.add(Secure.LOCATION_PROVIDERS_ALLOWED);
Amith Yamasani156c4352010-03-05 17:10:03 -0800746 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_ENABLED);
747 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_VISIBLE);
748 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800749 MOVED_TO_SECURE.add(Secure.LOGGING_ID);
750 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_ENABLED);
751 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_LAST_UPDATE);
752 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_REDIRECT_URL);
753 MOVED_TO_SECURE.add(Secure.SETTINGS_CLASSNAME);
754 MOVED_TO_SECURE.add(Secure.USB_MASS_STORAGE_ENABLED);
755 MOVED_TO_SECURE.add(Secure.USE_GOOGLE_MAIL);
756 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
757 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
758 MOVED_TO_SECURE.add(Secure.WIFI_NUM_OPEN_NETWORKS_KEPT);
759 MOVED_TO_SECURE.add(Secure.WIFI_ON);
760 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE);
761 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_AP_COUNT);
762 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS);
763 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED);
764 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS);
765 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT);
766 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_MAX_AP_CHECKS);
767 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ON);
768 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_COUNT);
769 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_DELAY_MS);
770 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS);
771 }
772
773 /**
774 * Look up a name in the database.
775 * @param resolver to access the database with
776 * @param name to look up in the table
777 * @return the corresponding value, or null if not present
778 */
779 public synchronized static String getString(ContentResolver resolver, String name) {
780 if (MOVED_TO_SECURE.contains(name)) {
781 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
782 + " to android.provider.Settings.Secure, returning read-only value.");
783 return Secure.getString(resolver, name);
784 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800785 if (sNameValueCache == null) {
786 sNameValueCache = new NameValueCache(SYS_PROP_SETTING_VERSION, CONTENT_URI,
787 CALL_METHOD_GET_SYSTEM);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800788 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800789 return sNameValueCache.getString(resolver, name);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800790 }
791
792 /**
793 * Store a name/value pair into the database.
794 * @param resolver to access the database with
795 * @param name to store
796 * @param value to associate with the name
797 * @return true if the value was set, false on database errors
798 */
799 public static boolean putString(ContentResolver resolver, String name, String value) {
800 if (MOVED_TO_SECURE.contains(name)) {
801 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
802 + " to android.provider.Settings.Secure, value is unchanged.");
803 return false;
804 }
805 return putString(resolver, CONTENT_URI, name, value);
806 }
807
808 /**
809 * Construct the content URI for a particular name/value pair,
810 * useful for monitoring changes with a ContentObserver.
811 * @param name to look up in the table
812 * @return the corresponding content URI, or null if not present
813 */
814 public static Uri getUriFor(String name) {
815 if (MOVED_TO_SECURE.contains(name)) {
816 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
817 + " to android.provider.Settings.Secure, returning Secure URI.");
818 return Secure.getUriFor(Secure.CONTENT_URI, name);
819 }
820 return getUriFor(CONTENT_URI, name);
821 }
822
823 /**
824 * Convenience function for retrieving a single system settings value
825 * as an integer. Note that internally setting values are always
826 * stored as strings; this function converts the string to an integer
827 * for you. The default value will be returned if the setting is
828 * not defined or not an integer.
829 *
830 * @param cr The ContentResolver to access.
831 * @param name The name of the setting to retrieve.
832 * @param def Value to return if the setting is not defined.
833 *
834 * @return The setting's current value, or 'def' if it is not defined
835 * or not a valid integer.
836 */
837 public static int getInt(ContentResolver cr, String name, int def) {
838 String v = getString(cr, name);
839 try {
840 return v != null ? Integer.parseInt(v) : def;
841 } catch (NumberFormatException e) {
842 return def;
843 }
844 }
845
846 /**
847 * Convenience function for retrieving a single system settings value
848 * as an integer. Note that internally setting values are always
849 * stored as strings; this function converts the string to an integer
850 * for you.
851 * <p>
852 * This version does not take a default value. If the setting has not
853 * been set, or the string value is not a number,
854 * it throws {@link SettingNotFoundException}.
855 *
856 * @param cr The ContentResolver to access.
857 * @param name The name of the setting to retrieve.
858 *
859 * @throws SettingNotFoundException Thrown if a setting by the given
860 * name can't be found or the setting value is not an integer.
861 *
862 * @return The setting's current value.
863 */
864 public static int getInt(ContentResolver cr, String name)
865 throws SettingNotFoundException {
866 String v = getString(cr, name);
867 try {
868 return Integer.parseInt(v);
869 } catch (NumberFormatException e) {
870 throw new SettingNotFoundException(name);
871 }
872 }
873
874 /**
875 * Convenience function for updating a single settings value as an
876 * integer. This will either create a new entry in the table if the
877 * given name does not exist, or modify the value of the existing row
878 * with that name. Note that internally setting values are always
879 * stored as strings, so this function converts the given value to a
880 * string before storing it.
881 *
882 * @param cr The ContentResolver to access.
883 * @param name The name of the setting to modify.
884 * @param value The new value for the setting.
885 * @return true if the value was set, false on database errors
886 */
887 public static boolean putInt(ContentResolver cr, String name, int value) {
888 return putString(cr, name, Integer.toString(value));
889 }
890
891 /**
892 * Convenience function for retrieving a single system settings value
893 * as a {@code long}. Note that internally setting values are always
894 * stored as strings; this function converts the string to a {@code long}
895 * for you. The default value will be returned if the setting is
896 * not defined or not a {@code long}.
897 *
898 * @param cr The ContentResolver to access.
899 * @param name The name of the setting to retrieve.
900 * @param def Value to return if the setting is not defined.
901 *
902 * @return The setting's current value, or 'def' if it is not defined
903 * or not a valid {@code long}.
904 */
905 public static long getLong(ContentResolver cr, String name, long def) {
906 String valString = getString(cr, name);
907 long value;
908 try {
909 value = valString != null ? Long.parseLong(valString) : def;
910 } catch (NumberFormatException e) {
911 value = def;
912 }
913 return value;
914 }
915
916 /**
917 * Convenience function for retrieving a single system settings value
918 * as a {@code long}. Note that internally setting values are always
919 * stored as strings; this function converts the string to a {@code long}
920 * for you.
921 * <p>
922 * This version does not take a default value. If the setting has not
923 * been set, or the string value is not a number,
924 * it throws {@link SettingNotFoundException}.
925 *
926 * @param cr The ContentResolver to access.
927 * @param name The name of the setting to retrieve.
928 *
929 * @return The setting's current value.
930 * @throws SettingNotFoundException Thrown if a setting by the given
931 * name can't be found or the setting value is not an integer.
932 */
933 public static long getLong(ContentResolver cr, String name)
934 throws SettingNotFoundException {
935 String valString = getString(cr, name);
936 try {
937 return Long.parseLong(valString);
938 } catch (NumberFormatException e) {
939 throw new SettingNotFoundException(name);
940 }
941 }
942
943 /**
944 * Convenience function for updating a single settings value as a long
945 * integer. This will either create a new entry in the table if the
946 * given name does not exist, or modify the value of the existing row
947 * with that name. Note that internally setting values are always
948 * stored as strings, so this function converts the given value to a
949 * string before storing it.
950 *
951 * @param cr The ContentResolver to access.
952 * @param name The name of the setting to modify.
953 * @param value The new value for the setting.
954 * @return true if the value was set, false on database errors
955 */
956 public static boolean putLong(ContentResolver cr, String name, long value) {
957 return putString(cr, name, Long.toString(value));
958 }
959
960 /**
961 * Convenience function for retrieving a single system settings value
962 * as a floating point number. Note that internally setting values are
963 * always stored as strings; this function converts the string to an
964 * float for you. The default value will be returned if the setting
965 * is not defined or not a valid float.
966 *
967 * @param cr The ContentResolver to access.
968 * @param name The name of the setting to retrieve.
969 * @param def Value to return if the setting is not defined.
970 *
971 * @return The setting's current value, or 'def' if it is not defined
972 * or not a valid float.
973 */
974 public static float getFloat(ContentResolver cr, String name, float def) {
975 String v = getString(cr, name);
976 try {
977 return v != null ? Float.parseFloat(v) : def;
978 } catch (NumberFormatException e) {
979 return def;
980 }
981 }
982
983 /**
984 * Convenience function for retrieving a single system settings value
985 * as a float. Note that internally setting values are always
986 * stored as strings; this function converts the string to a float
987 * for you.
988 * <p>
989 * This version does not take a default value. If the setting has not
990 * been set, or the string value is not a number,
991 * it throws {@link SettingNotFoundException}.
992 *
993 * @param cr The ContentResolver to access.
994 * @param name The name of the setting to retrieve.
995 *
996 * @throws SettingNotFoundException Thrown if a setting by the given
997 * name can't be found or the setting value is not a float.
998 *
999 * @return The setting's current value.
1000 */
1001 public static float getFloat(ContentResolver cr, String name)
1002 throws SettingNotFoundException {
1003 String v = getString(cr, name);
Brian Muramatsue1d46982010-12-06 17:34:20 -08001004 if (v == null) {
1005 throw new SettingNotFoundException(name);
1006 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001007 try {
1008 return Float.parseFloat(v);
1009 } catch (NumberFormatException e) {
1010 throw new SettingNotFoundException(name);
1011 }
1012 }
1013
1014 /**
1015 * Convenience function for updating a single settings value as a
1016 * floating point number. This will either create a new entry in the
1017 * table if the given name does not exist, or modify the value of the
1018 * existing row with that name. Note that internally setting values
1019 * are always stored as strings, so this function converts the given
1020 * value to a string before storing it.
1021 *
1022 * @param cr The ContentResolver to access.
1023 * @param name The name of the setting to modify.
1024 * @param value The new value for the setting.
1025 * @return true if the value was set, false on database errors
1026 */
1027 public static boolean putFloat(ContentResolver cr, String name, float value) {
1028 return putString(cr, name, Float.toString(value));
1029 }
1030
1031 /**
1032 * Convenience function to read all of the current
1033 * configuration-related settings into a
1034 * {@link Configuration} object.
1035 *
1036 * @param cr The ContentResolver to access.
1037 * @param outConfig Where to place the configuration settings.
1038 */
1039 public static void getConfiguration(ContentResolver cr, Configuration outConfig) {
1040 outConfig.fontScale = Settings.System.getFloat(
1041 cr, FONT_SCALE, outConfig.fontScale);
1042 if (outConfig.fontScale < 0) {
1043 outConfig.fontScale = 1;
1044 }
1045 }
1046
1047 /**
1048 * Convenience function to write a batch of configuration-related
1049 * settings from a {@link Configuration} object.
1050 *
1051 * @param cr The ContentResolver to access.
1052 * @param config The settings to write.
1053 * @return true if the values were set, false on database errors
1054 */
1055 public static boolean putConfiguration(ContentResolver cr, Configuration config) {
1056 return Settings.System.putFloat(cr, FONT_SCALE, config.fontScale);
1057 }
1058
Dianne Hackbornb8b11a02010-03-10 15:53:11 -08001059 /** @hide */
1060 public static boolean hasInterestingConfigurationChanges(int changes) {
1061 return (changes&ActivityInfo.CONFIG_FONT_SCALE) != 0;
1062 }
Jaikumar Ganesh545e6702010-06-04 10:23:03 -07001063
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001064 public static boolean getShowGTalkServiceStatus(ContentResolver cr) {
1065 return getInt(cr, SHOW_GTALK_SERVICE_STATUS, 0) != 0;
1066 }
1067
1068 public static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag) {
1069 putInt(cr, SHOW_GTALK_SERVICE_STATUS, flag ? 1 : 0);
1070 }
1071
1072 /**
1073 * The content:// style URL for this table
1074 */
1075 public static final Uri CONTENT_URI =
1076 Uri.parse("content://" + AUTHORITY + "/system");
1077
1078 /**
1079 * Whether we keep the device on while the device is plugged in.
1080 * Supported values are:
1081 * <ul>
1082 * <li>{@code 0} to never stay on while plugged in</li>
1083 * <li>{@link BatteryManager#BATTERY_PLUGGED_AC} to stay on for AC charger</li>
1084 * <li>{@link BatteryManager#BATTERY_PLUGGED_USB} to stay on for USB charger</li>
1085 * </ul>
1086 * These values can be OR-ed together.
1087 */
1088 public static final String STAY_ON_WHILE_PLUGGED_IN = "stay_on_while_plugged_in";
1089
1090 /**
1091 * What happens when the user presses the end call button if they're not
1092 * on a call.<br/>
1093 * <b>Values:</b><br/>
1094 * 0 - The end button does nothing.<br/>
1095 * 1 - The end button goes to the home screen.<br/>
1096 * 2 - The end button puts the device to sleep and locks the keyguard.<br/>
1097 * 3 - The end button goes to the home screen. If the user is already on the
1098 * home screen, it puts the device to sleep.
1099 */
1100 public static final String END_BUTTON_BEHAVIOR = "end_button_behavior";
1101
1102 /**
David Brown458e8062010-03-08 21:52:11 -08001103 * END_BUTTON_BEHAVIOR value for "go home".
1104 * @hide
1105 */
1106 public static final int END_BUTTON_BEHAVIOR_HOME = 0x1;
1107
1108 /**
1109 * END_BUTTON_BEHAVIOR value for "go to sleep".
1110 * @hide
1111 */
1112 public static final int END_BUTTON_BEHAVIOR_SLEEP = 0x2;
1113
1114 /**
1115 * END_BUTTON_BEHAVIOR default value.
1116 * @hide
1117 */
1118 public static final int END_BUTTON_BEHAVIOR_DEFAULT = END_BUTTON_BEHAVIOR_SLEEP;
1119
1120 /**
Joe Onorato9cdffa12011-04-06 18:27:27 -07001121 * Is advanced settings mode turned on. 0 == no, 1 == yes
1122 * @hide
1123 */
1124 public static final String ADVANCED_SETTINGS = "advanced_settings";
1125
1126 /**
1127 * ADVANCED_SETTINGS default value.
1128 * @hide
1129 */
1130 public static final int ADVANCED_SETTINGS_DEFAULT = 0;
1131
1132 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001133 * Whether Airplane Mode is on.
1134 */
1135 public static final String AIRPLANE_MODE_ON = "airplane_mode_on";
1136
1137 /**
1138 * Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
1139 */
1140 public static final String RADIO_BLUETOOTH = "bluetooth";
1141
1142 /**
1143 * Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
1144 */
1145 public static final String RADIO_WIFI = "wifi";
1146
1147 /**
1148 * Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
1149 */
1150 public static final String RADIO_CELL = "cell";
1151
1152 /**
1153 * A comma separated list of radios that need to be disabled when airplane mode
1154 * is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are
1155 * included in the comma separated list.
1156 */
1157 public static final String AIRPLANE_MODE_RADIOS = "airplane_mode_radios";
1158
1159 /**
Mike Lockwoodbd5ddf02009-07-29 21:37:14 -07001160 * A comma separated list of radios that should to be disabled when airplane mode
1161 * is on, but can be manually reenabled by the user. For example, if RADIO_WIFI is
1162 * added to both AIRPLANE_MODE_RADIOS and AIRPLANE_MODE_TOGGLEABLE_RADIOS, then Wifi
1163 * will be turned off when entering airplane mode, but the user will be able to reenable
1164 * Wifi in the Settings app.
1165 *
1166 * {@hide}
1167 */
1168 public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS = "airplane_mode_toggleable_radios";
1169
1170 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001171 * The policy for deciding when Wi-Fi should go to sleep (which will in
1172 * turn switch to using the mobile data as an Internet connection).
1173 * <p>
1174 * Set to one of {@link #WIFI_SLEEP_POLICY_DEFAULT},
1175 * {@link #WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED}, or
1176 * {@link #WIFI_SLEEP_POLICY_NEVER}.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001177 */
1178 public static final String WIFI_SLEEP_POLICY = "wifi_sleep_policy";
1179
1180 /**
1181 * Value for {@link #WIFI_SLEEP_POLICY} to use the default Wi-Fi sleep
1182 * policy, which is to sleep shortly after the turning off
1183 * according to the {@link #STAY_ON_WHILE_PLUGGED_IN} setting.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001184 */
1185 public static final int WIFI_SLEEP_POLICY_DEFAULT = 0;
1186
1187 /**
1188 * Value for {@link #WIFI_SLEEP_POLICY} to use the default policy when
1189 * the device is on battery, and never go to sleep when the device is
1190 * plugged in.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001191 */
1192 public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED = 1;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001193
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001194 /**
1195 * Value for {@link #WIFI_SLEEP_POLICY} to never go to sleep.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001196 */
1197 public static final int WIFI_SLEEP_POLICY_NEVER = 2;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001198
Irfan Sheriff31b62322010-08-30 12:26:00 -07001199 //TODO: deprecate static IP constants
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001200 /**
1201 * Whether to use static IP and other static network attributes.
1202 * <p>
1203 * Set to 1 for true and 0 for false.
1204 */
1205 public static final String WIFI_USE_STATIC_IP = "wifi_use_static_ip";
1206
1207 /**
1208 * The static IP address.
1209 * <p>
1210 * Example: "192.168.1.51"
1211 */
1212 public static final String WIFI_STATIC_IP = "wifi_static_ip";
1213
1214 /**
1215 * If using static IP, the gateway's IP address.
1216 * <p>
1217 * Example: "192.168.1.1"
1218 */
1219 public static final String WIFI_STATIC_GATEWAY = "wifi_static_gateway";
1220
1221 /**
1222 * If using static IP, the net mask.
1223 * <p>
1224 * Example: "255.255.255.0"
1225 */
1226 public static final String WIFI_STATIC_NETMASK = "wifi_static_netmask";
1227
1228 /**
1229 * If using static IP, the primary DNS's IP address.
1230 * <p>
1231 * Example: "192.168.1.1"
1232 */
1233 public static final String WIFI_STATIC_DNS1 = "wifi_static_dns1";
1234
1235 /**
1236 * If using static IP, the secondary DNS's IP address.
1237 * <p>
1238 * Example: "192.168.1.2"
1239 */
1240 public static final String WIFI_STATIC_DNS2 = "wifi_static_dns2";
1241
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001242
1243 /**
1244 * Determines whether remote devices may discover and/or connect to
1245 * this device.
1246 * <P>Type: INT</P>
1247 * 2 -- discoverable and connectable
1248 * 1 -- connectable but not discoverable
1249 * 0 -- neither connectable nor discoverable
1250 */
1251 public static final String BLUETOOTH_DISCOVERABILITY =
1252 "bluetooth_discoverability";
1253
1254 /**
1255 * Bluetooth discoverability timeout. If this value is nonzero, then
1256 * Bluetooth becomes discoverable for a certain number of seconds,
1257 * after which is becomes simply connectable. The value is in seconds.
1258 */
1259 public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT =
1260 "bluetooth_discoverability_timeout";
1261
1262 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08001263 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_ENABLED}
1264 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001265 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001266 @Deprecated
1267 public static final String LOCK_PATTERN_ENABLED = Secure.LOCK_PATTERN_ENABLED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001268
1269 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08001270 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_VISIBLE}
1271 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001272 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001273 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001274 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
1275
1276 /**
Jaikumar Ganesh545e6702010-06-04 10:23:03 -07001277 * @deprecated Use
Amith Yamasani156c4352010-03-05 17:10:03 -08001278 * {@link android.provider.Settings.Secure#LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED}
1279 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001280 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001281 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001282 public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
1283 "lock_pattern_tactile_feedback_enabled";
1284
1285
1286 /**
1287 * A formatted string of the next alarm that is set, or the empty string
1288 * if there is no alarm set.
1289 */
1290 public static final String NEXT_ALARM_FORMATTED = "next_alarm_formatted";
1291
1292 /**
1293 * Scaling factor for fonts, float.
1294 */
1295 public static final String FONT_SCALE = "font_scale";
1296
1297 /**
1298 * Name of an application package to be debugged.
1299 */
1300 public static final String DEBUG_APP = "debug_app";
1301
1302 /**
1303 * If 1, when launching DEBUG_APP it will wait for the debugger before
1304 * starting user code. If 0, it will run normally.
1305 */
1306 public static final String WAIT_FOR_DEBUGGER = "wait_for_debugger";
1307
1308 /**
1309 * Whether or not to dim the screen. 0=no 1=yes
1310 */
1311 public static final String DIM_SCREEN = "dim_screen";
1312
1313 /**
1314 * The timeout before the screen turns off.
1315 */
1316 public static final String SCREEN_OFF_TIMEOUT = "screen_off_timeout";
1317
1318 /**
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -07001319 * If 0, the compatibility mode is off for all applications.
1320 * If 1, older applications run under compatibility mode.
1321 * TODO: remove this settings before code freeze (bug/1907571)
1322 * @hide
1323 */
1324 public static final String COMPATIBILITY_MODE = "compatibility_mode";
1325
1326 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001327 * The screen backlight brightness between 0 and 255.
1328 */
1329 public static final String SCREEN_BRIGHTNESS = "screen_brightness";
1330
1331 /**
Dan Murphy951764b2009-08-27 14:59:03 -05001332 * Control whether to enable automatic brightness mode.
Dan Murphy951764b2009-08-27 14:59:03 -05001333 */
1334 public static final String SCREEN_BRIGHTNESS_MODE = "screen_brightness_mode";
1335
1336 /**
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001337 * SCREEN_BRIGHTNESS_MODE value for manual mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001338 */
1339 public static final int SCREEN_BRIGHTNESS_MODE_MANUAL = 0;
1340
1341 /**
1342 * SCREEN_BRIGHTNESS_MODE value for manual mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001343 */
1344 public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC = 1;
1345
1346 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001347 * Control whether the process CPU usage meter should be shown.
1348 */
1349 public static final String SHOW_PROCESSES = "show_processes";
1350
1351 /**
1352 * If 1, the activity manager will aggressively finish activities and
1353 * processes as soon as they are no longer needed. If 0, the normal
1354 * extended lifetime is used.
1355 */
1356 public static final String ALWAYS_FINISH_ACTIVITIES =
1357 "always_finish_activities";
1358
1359
1360 /**
1361 * Ringer mode. This is used internally, changing this value will not
1362 * change the ringer mode. See AudioManager.
1363 */
1364 public static final String MODE_RINGER = "mode_ringer";
1365
1366 /**
1367 * Determines which streams are affected by ringer mode changes. The
1368 * stream type's bit should be set to 1 if it should be muted when going
1369 * into an inaudible ringer mode.
1370 */
1371 public static final String MODE_RINGER_STREAMS_AFFECTED = "mode_ringer_streams_affected";
1372
1373 /**
1374 * Determines which streams are affected by mute. The
1375 * stream type's bit should be set to 1 if it should be muted when a mute request
1376 * is received.
1377 */
1378 public static final String MUTE_STREAMS_AFFECTED = "mute_streams_affected";
1379
1380 /**
1381 * Whether vibrate is on for different events. This is used internally,
1382 * changing this value will not change the vibrate. See AudioManager.
1383 */
1384 public static final String VIBRATE_ON = "vibrate_on";
1385
1386 /**
1387 * Ringer volume. This is used internally, changing this value will not
1388 * change the volume. See AudioManager.
1389 */
1390 public static final String VOLUME_RING = "volume_ring";
1391
1392 /**
1393 * System/notifications volume. This is used internally, changing this
1394 * value will not change the volume. See AudioManager.
1395 */
1396 public static final String VOLUME_SYSTEM = "volume_system";
1397
1398 /**
1399 * Voice call volume. This is used internally, changing this value will
1400 * not change the volume. See AudioManager.
1401 */
1402 public static final String VOLUME_VOICE = "volume_voice";
1403
1404 /**
1405 * Music/media/gaming volume. This is used internally, changing this
1406 * value will not change the volume. See AudioManager.
1407 */
1408 public static final String VOLUME_MUSIC = "volume_music";
1409
1410 /**
1411 * Alarm volume. This is used internally, changing this
1412 * value will not change the volume. See AudioManager.
1413 */
1414 public static final String VOLUME_ALARM = "volume_alarm";
1415
1416 /**
1417 * Notification volume. This is used internally, changing this
1418 * value will not change the volume. See AudioManager.
1419 */
1420 public static final String VOLUME_NOTIFICATION = "volume_notification";
1421
1422 /**
Eric Laurent484d2882009-12-08 09:05:45 -08001423 * Bluetooth Headset volume. This is used internally, changing this value will
1424 * not change the volume. See AudioManager.
1425 */
1426 public static final String VOLUME_BLUETOOTH_SCO = "volume_bluetooth_sco";
1427
1428 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001429 * Whether the notifications should use the ring volume (value of 1) or
1430 * a separate notification volume (value of 0). In most cases, users
1431 * will have this enabled so the notification and ringer volumes will be
1432 * the same. However, power users can disable this and use the separate
1433 * notification volume control.
1434 * <p>
1435 * Note: This is a one-off setting that will be removed in the future
1436 * when there is profile support. For this reason, it is kept hidden
1437 * from the public APIs.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001438 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001439 * @hide
1440 */
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001441 public static final String NOTIFICATIONS_USE_RING_VOLUME =
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001442 "notifications_use_ring_volume";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001443
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001444 /**
Daniel Sandler6329bf72010-02-26 15:17:44 -05001445 * Whether silent mode should allow vibration feedback. This is used
1446 * internally in AudioService and the Sound settings activity to
1447 * coordinate decoupling of vibrate and silent modes. This setting
1448 * will likely be removed in a future release with support for
1449 * audio/vibe feedback profiles.
1450 *
1451 * @hide
1452 */
1453 public static final String VIBRATE_IN_SILENT = "vibrate_in_silent";
1454
1455 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001456 * The mapping of stream type (integer) to its setting.
1457 */
1458 public static final String[] VOLUME_SETTINGS = {
1459 VOLUME_VOICE, VOLUME_SYSTEM, VOLUME_RING, VOLUME_MUSIC,
Eric Laurent484d2882009-12-08 09:05:45 -08001460 VOLUME_ALARM, VOLUME_NOTIFICATION, VOLUME_BLUETOOTH_SCO
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001461 };
1462
1463 /**
1464 * Appended to various volume related settings to record the previous
1465 * values before they the settings were affected by a silent/vibrate
1466 * ringer mode change.
1467 */
1468 public static final String APPEND_FOR_LAST_AUDIBLE = "_last_audible";
1469
1470 /**
1471 * Persistent store for the system-wide default ringtone URI.
1472 * <p>
1473 * If you need to play the default ringtone at any given time, it is recommended
1474 * you give {@link #DEFAULT_RINGTONE_URI} to the media player. It will resolve
1475 * to the set default ringtone at the time of playing.
1476 *
1477 * @see #DEFAULT_RINGTONE_URI
1478 */
1479 public static final String RINGTONE = "ringtone";
1480
1481 /**
1482 * A {@link Uri} that will point to the current default ringtone at any
1483 * given time.
1484 * <p>
1485 * If the current default ringtone is in the DRM provider and the caller
1486 * does not have permission, the exception will be a
1487 * FileNotFoundException.
1488 */
1489 public static final Uri DEFAULT_RINGTONE_URI = getUriFor(RINGTONE);
1490
1491 /**
1492 * Persistent store for the system-wide default notification sound.
1493 *
1494 * @see #RINGTONE
1495 * @see #DEFAULT_NOTIFICATION_URI
1496 */
1497 public static final String NOTIFICATION_SOUND = "notification_sound";
1498
1499 /**
1500 * A {@link Uri} that will point to the current default notification
1501 * sound at any given time.
1502 *
1503 * @see #DEFAULT_RINGTONE_URI
1504 */
1505 public static final Uri DEFAULT_NOTIFICATION_URI = getUriFor(NOTIFICATION_SOUND);
1506
1507 /**
Patrick Scott3156bb002009-04-13 09:57:38 -07001508 * Persistent store for the system-wide default alarm alert.
1509 *
1510 * @see #RINGTONE
1511 * @see #DEFAULT_ALARM_ALERT_URI
1512 */
1513 public static final String ALARM_ALERT = "alarm_alert";
1514
1515 /**
1516 * A {@link Uri} that will point to the current default alarm alert at
1517 * any given time.
1518 *
1519 * @see #DEFAULT_ALARM_ALERT_URI
1520 */
1521 public static final Uri DEFAULT_ALARM_ALERT_URI = getUriFor(ALARM_ALERT);
1522
1523 /**
Jean-Michel Trivid589fea2011-04-15 11:28:10 -07001524 * Persistent store for the system default media button event receiver.
1525 *
1526 * @hide
1527 */
1528 public static final String MEDIA_BUTTON_RECEIVER = "media_button_receiver";
1529
1530 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001531 * Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off
1532 */
1533 public static final String TEXT_AUTO_REPLACE = "auto_replace";
1534
1535 /**
1536 * Setting to enable Auto Caps in text editors. 1 = On, 0 = Off
1537 */
1538 public static final String TEXT_AUTO_CAPS = "auto_caps";
1539
1540 /**
1541 * Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This
1542 * feature converts two spaces to a "." and space.
1543 */
1544 public static final String TEXT_AUTO_PUNCTUATE = "auto_punctuate";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001545
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001546 /**
1547 * Setting to showing password characters in text editors. 1 = On, 0 = Off
1548 */
1549 public static final String TEXT_SHOW_PASSWORD = "show_password";
1550
1551 public static final String SHOW_GTALK_SERVICE_STATUS =
1552 "SHOW_GTALK_SERVICE_STATUS";
1553
1554 /**
1555 * Name of activity to use for wallpaper on the home screen.
1556 */
1557 public static final String WALLPAPER_ACTIVITY = "wallpaper_activity";
1558
1559 /**
1560 * Value to specify if the user prefers the date, time and time zone
1561 * to be automatically fetched from the network (NITZ). 1=yes, 0=no
1562 */
1563 public static final String AUTO_TIME = "auto_time";
1564
1565 /**
Amith Yamasaniad450be2010-09-16 16:47:00 -07001566 * Value to specify if the user prefers the time zone
1567 * to be automatically fetched from the network (NITZ). 1=yes, 0=no
1568 */
1569 public static final String AUTO_TIME_ZONE = "auto_time_zone";
1570
1571 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001572 * Display times as 12 or 24 hours
1573 * 12
1574 * 24
1575 */
1576 public static final String TIME_12_24 = "time_12_24";
1577
1578 /**
1579 * Date format string
1580 * mm/dd/yyyy
1581 * dd/mm/yyyy
1582 * yyyy/mm/dd
1583 */
1584 public static final String DATE_FORMAT = "date_format";
1585
1586 /**
1587 * Whether the setup wizard has been run before (on first boot), or if
1588 * it still needs to be run.
1589 *
1590 * nonzero = it has been run in the past
1591 * 0 = it has not been run in the past
1592 */
1593 public static final String SETUP_WIZARD_HAS_RUN = "setup_wizard_has_run";
1594
1595 /**
1596 * Scaling factor for normal window animations. Setting to 0 will disable window
1597 * animations.
1598 */
1599 public static final String WINDOW_ANIMATION_SCALE = "window_animation_scale";
1600
1601 /**
1602 * Scaling factor for activity transition animations. Setting to 0 will disable window
1603 * animations.
1604 */
1605 public static final String TRANSITION_ANIMATION_SCALE = "transition_animation_scale";
1606
1607 /**
1608 * Scaling factor for normal window animations. Setting to 0 will disable window
1609 * animations.
1610 * @hide
1611 */
1612 public static final String FANCY_IME_ANIMATIONS = "fancy_ime_animations";
1613
1614 /**
1615 * Control whether the accelerometer will be used to change screen
1616 * orientation. If 0, it will not be used unless explicitly requested
1617 * by the application; if 1, it will be used by default unless explicitly
1618 * disabled by the application.
1619 */
1620 public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
1621
1622 /**
Daniel Sandlerb73617d2010-08-17 00:41:00 -04001623 * Default screen rotation when no other policy applies.
1624 * When {@link #ACCELEROMETER_ROTATION} is zero and no on-screen Activity expresses a
1625 * preference, this rotation value will be used. Must be one of the
Brian Muramatsue1d46982010-12-06 17:34:20 -08001626 * {@link android.view.Surface#ROTATION_0 Surface rotation constants}.
Daniel Sandlerb73617d2010-08-17 00:41:00 -04001627 *
1628 * @see Display#getRotation
1629 */
1630 public static final String USER_ROTATION = "user_rotation";
1631
1632 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001633 * Whether the audible DTMF tones are played by the dialer when dialing. The value is
1634 * boolean (1 or 0).
1635 */
1636 public static final String DTMF_TONE_WHEN_DIALING = "dtmf_tone";
1637
1638 /**
David Kraused0f67152009-06-13 18:01:13 -05001639 * CDMA only settings
1640 * DTMF tone type played by the dialer when dialing.
1641 * 0 = Normal
1642 * 1 = Long
1643 * @hide
1644 */
1645 public static final String DTMF_TONE_TYPE_WHEN_DIALING = "dtmf_tone_type";
1646
1647 /**
1648 * CDMA only settings
1649 * Emergency Tone 0 = Off
1650 * 1 = Alert
1651 * 2 = Vibrate
1652 * @hide
1653 */
1654 public static final String EMERGENCY_TONE = "emergency_tone";
1655
1656 /**
1657 * CDMA only settings
1658 * Whether the auto retry is enabled. The value is
1659 * boolean (1 or 0).
1660 * @hide
1661 */
1662 public static final String CALL_AUTO_RETRY = "call_auto_retry";
1663
1664 /**
1665 * Whether the hearing aid is enabled. The value is
1666 * boolean (1 or 0).
1667 * @hide
1668 */
1669 public static final String HEARING_AID = "hearing_aid";
1670
1671 /**
1672 * CDMA only settings
1673 * TTY Mode
1674 * 0 = OFF
1675 * 1 = FULL
1676 * 2 = VCO
1677 * 3 = HCO
1678 * @hide
1679 */
1680 public static final String TTY_MODE = "tty_mode";
1681
1682 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001683 * Whether the sounds effects (key clicks, lid open ...) are enabled. The value is
1684 * boolean (1 or 0).
1685 */
1686 public static final String SOUND_EFFECTS_ENABLED = "sound_effects_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001687
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001688 /**
1689 * Whether the haptic feedback (long presses, ...) are enabled. The value is
1690 * boolean (1 or 0).
1691 */
1692 public static final String HAPTIC_FEEDBACK_ENABLED = "haptic_feedback_enabled";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07001693
Mike LeBeau48603e72009-06-05 00:27:00 +01001694 /**
Bjorn Bringert24abb662010-09-21 12:21:18 +01001695 * @deprecated Each application that shows web suggestions should have its own
1696 * setting for this.
Mike LeBeau48603e72009-06-05 00:27:00 +01001697 */
Bjorn Bringert24abb662010-09-21 12:21:18 +01001698 @Deprecated
Mike LeBeau48603e72009-06-05 00:27:00 +01001699 public static final String SHOW_WEB_SUGGESTIONS = "show_web_suggestions";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001700
-b master501eec92009-07-06 13:53:11 -07001701 /**
Amith Yamasaniae3ed702009-12-01 19:02:05 -08001702 * Whether the notification LED should repeatedly flash when a notification is
1703 * pending. The value is boolean (1 or 0).
1704 * @hide
1705 */
1706 public static final String NOTIFICATION_LIGHT_PULSE = "notification_light_pulse";
1707
1708 /**
Dianne Hackborn90d2db32010-02-11 22:19:06 -08001709 * Show pointer location on screen?
1710 * 0 = no
1711 * 1 = yes
1712 * @hide
1713 */
1714 public static final String POINTER_LOCATION = "pointer_location";
1715
1716 /**
Jeff Brown4519f072011-01-23 13:16:01 -08001717 * Log raw orientation data from {@link WindowOrientationListener} for use with the
1718 * orientationplot.py tool.
1719 * 0 = no
1720 * 1 = yes
1721 * @hide
1722 */
1723 public static final String WINDOW_ORIENTATION_LISTENER_LOG =
1724 "window_orientation_listener_log";
1725
1726 /**
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05001727 * Whether to play a sound for low-battery alerts.
1728 * @hide
1729 */
1730 public static final String POWER_SOUNDS_ENABLED = "power_sounds_enabled";
1731
1732 /**
1733 * Whether to play a sound for dock events.
1734 * @hide
1735 */
1736 public static final String DOCK_SOUNDS_ENABLED = "dock_sounds_enabled";
1737
1738 /**
1739 * Whether to play sounds when the keyguard is shown and dismissed.
1740 * @hide
1741 */
1742 public static final String LOCKSCREEN_SOUNDS_ENABLED = "lockscreen_sounds_enabled";
1743
1744 /**
1745 * URI for the low battery sound file.
1746 * @hide
1747 */
1748 public static final String LOW_BATTERY_SOUND = "low_battery_sound";
1749
1750 /**
1751 * URI for the desk dock "in" event sound.
1752 * @hide
1753 */
1754 public static final String DESK_DOCK_SOUND = "desk_dock_sound";
1755
1756 /**
1757 * URI for the desk dock "out" event sound.
1758 * @hide
1759 */
1760 public static final String DESK_UNDOCK_SOUND = "desk_undock_sound";
1761
1762 /**
1763 * URI for the car dock "in" event sound.
1764 * @hide
1765 */
1766 public static final String CAR_DOCK_SOUND = "car_dock_sound";
1767
1768 /**
1769 * URI for the car dock "out" event sound.
1770 * @hide
1771 */
1772 public static final String CAR_UNDOCK_SOUND = "car_undock_sound";
1773
1774 /**
1775 * URI for the "device locked" (keyguard shown) sound.
1776 * @hide
1777 */
1778 public static final String LOCK_SOUND = "lock_sound";
1779
1780 /**
1781 * URI for the "device unlocked" (keyguard dismissed) sound.
1782 * @hide
1783 */
1784 public static final String UNLOCK_SOUND = "unlock_sound";
1785
1786 /**
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08001787 * Receive incoming SIP calls?
1788 * 0 = no
1789 * 1 = yes
1790 * @hide
1791 */
1792 public static final String SIP_RECEIVE_CALLS = "sip_receive_calls";
1793
1794 /**
1795 * Call Preference String.
1796 * "SIP_ALWAYS" : Always use SIP with network access
1797 * "SIP_ADDRESS_ONLY" : Only if destination is a SIP address
1798 * "SIP_ASK_ME_EACH_TIME" : Always ask me each time
1799 * @hide
1800 */
1801 public static final String SIP_CALL_OPTIONS = "sip_call_options";
1802
1803 /**
1804 * One of the sip call options: Always use SIP with network access.
1805 * @hide
1806 */
1807 public static final String SIP_ALWAYS = "SIP_ALWAYS";
1808
1809 /**
1810 * One of the sip call options: Only if destination is a SIP address.
1811 * @hide
1812 */
1813 public static final String SIP_ADDRESS_ONLY = "SIP_ADDRESS_ONLY";
1814
1815 /**
1816 * One of the sip call options: Always ask me each time.
1817 * @hide
1818 */
1819 public static final String SIP_ASK_ME_EACH_TIME = "SIP_ASK_ME_EACH_TIME";
1820
1821 /**
Jeff Brown1a84fd12011-06-02 01:26:32 -07001822 * Pointer speed setting.
1823 * This is an integer value in a range between -7 and +7, so there are 15 possible values.
1824 * -7 = slowest
1825 * 0 = default speed
1826 * +7 = fastest
1827 * @hide
1828 */
1829 public static final String POINTER_SPEED = "pointer_speed";
1830
1831 /**
-b master501eec92009-07-06 13:53:11 -07001832 * Settings to backup. This is here so that it's in the same place as the settings
1833 * keys and easy to update.
1834 * @hide
1835 */
1836 public static final String[] SETTINGS_TO_BACKUP = {
1837 STAY_ON_WHILE_PLUGGED_IN,
-b master501eec92009-07-06 13:53:11 -07001838 WIFI_USE_STATIC_IP,
1839 WIFI_STATIC_IP,
1840 WIFI_STATIC_GATEWAY,
1841 WIFI_STATIC_NETMASK,
1842 WIFI_STATIC_DNS1,
1843 WIFI_STATIC_DNS2,
1844 BLUETOOTH_DISCOVERABILITY,
1845 BLUETOOTH_DISCOVERABILITY_TIMEOUT,
1846 DIM_SCREEN,
1847 SCREEN_OFF_TIMEOUT,
1848 SCREEN_BRIGHTNESS,
Christopher Tate362aca62009-09-25 15:58:03 -07001849 SCREEN_BRIGHTNESS_MODE,
-b master501eec92009-07-06 13:53:11 -07001850 VIBRATE_ON,
Amith Yamasani8823c0a82009-07-07 14:30:17 -07001851 MODE_RINGER,
1852 MODE_RINGER_STREAMS_AFFECTED,
1853 MUTE_STREAMS_AFFECTED,
1854 VOLUME_VOICE,
1855 VOLUME_SYSTEM,
1856 VOLUME_RING,
1857 VOLUME_MUSIC,
1858 VOLUME_ALARM,
1859 VOLUME_NOTIFICATION,
Eric Laurent484d2882009-12-08 09:05:45 -08001860 VOLUME_BLUETOOTH_SCO,
Amith Yamasani8823c0a82009-07-07 14:30:17 -07001861 VOLUME_VOICE + APPEND_FOR_LAST_AUDIBLE,
1862 VOLUME_SYSTEM + APPEND_FOR_LAST_AUDIBLE,
1863 VOLUME_RING + APPEND_FOR_LAST_AUDIBLE,
1864 VOLUME_MUSIC + APPEND_FOR_LAST_AUDIBLE,
1865 VOLUME_ALARM + APPEND_FOR_LAST_AUDIBLE,
1866 VOLUME_NOTIFICATION + APPEND_FOR_LAST_AUDIBLE,
Eric Laurent484d2882009-12-08 09:05:45 -08001867 VOLUME_BLUETOOTH_SCO + APPEND_FOR_LAST_AUDIBLE,
Daniel Sandler1c7fa482010-03-10 09:45:01 -05001868 VIBRATE_IN_SILENT,
-b master501eec92009-07-06 13:53:11 -07001869 TEXT_AUTO_REPLACE,
1870 TEXT_AUTO_CAPS,
1871 TEXT_AUTO_PUNCTUATE,
1872 TEXT_SHOW_PASSWORD,
1873 AUTO_TIME,
Amith Yamasaniad450be2010-09-16 16:47:00 -07001874 AUTO_TIME_ZONE,
-b master501eec92009-07-06 13:53:11 -07001875 TIME_12_24,
1876 DATE_FORMAT,
1877 ACCELEROMETER_ROTATION,
Daniel Sandlerb73617d2010-08-17 00:41:00 -04001878 USER_ROTATION,
-b master501eec92009-07-06 13:53:11 -07001879 DTMF_TONE_WHEN_DIALING,
1880 DTMF_TONE_TYPE_WHEN_DIALING,
1881 EMERGENCY_TONE,
1882 CALL_AUTO_RETRY,
1883 HEARING_AID,
1884 TTY_MODE,
1885 SOUND_EFFECTS_ENABLED,
1886 HAPTIC_FEEDBACK_ENABLED,
Christopher Tate14c2d792010-02-25 16:49:44 -08001887 POWER_SOUNDS_ENABLED,
1888 DOCK_SOUNDS_ENABLED,
1889 LOCKSCREEN_SOUNDS_ENABLED,
Amith Yamasaniae3ed702009-12-01 19:02:05 -08001890 SHOW_WEB_SUGGESTIONS,
Mike Lockwoodeabe8bf2010-08-31 14:35:23 -04001891 NOTIFICATION_LIGHT_PULSE,
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08001892 SIP_CALL_OPTIONS,
Nick Pelly038cabe2010-09-23 16:12:11 -07001893 SIP_RECEIVE_CALLS,
Jeff Brown1a84fd12011-06-02 01:26:32 -07001894 POINTER_SPEED,
-b master501eec92009-07-06 13:53:11 -07001895 };
1896
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001897 // Settings moved to Settings.Secure
1898
1899 /**
Mike Lockwood460ae0c2009-04-02 22:33:27 -07001900 * @deprecated Use {@link android.provider.Settings.Secure#ADB_ENABLED}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001901 * instead
1902 */
1903 @Deprecated
1904 public static final String ADB_ENABLED = Secure.ADB_ENABLED;
1905
1906 /**
1907 * @deprecated Use {@link android.provider.Settings.Secure#ANDROID_ID} instead
1908 */
1909 @Deprecated
1910 public static final String ANDROID_ID = Secure.ANDROID_ID;
1911
1912 /**
1913 * @deprecated Use {@link android.provider.Settings.Secure#BLUETOOTH_ON} instead
1914 */
1915 @Deprecated
1916 public static final String BLUETOOTH_ON = Secure.BLUETOOTH_ON;
1917
1918 /**
1919 * @deprecated Use {@link android.provider.Settings.Secure#DATA_ROAMING} instead
1920 */
1921 @Deprecated
1922 public static final String DATA_ROAMING = Secure.DATA_ROAMING;
1923
1924 /**
1925 * @deprecated Use {@link android.provider.Settings.Secure#DEVICE_PROVISIONED} instead
1926 */
1927 @Deprecated
1928 public static final String DEVICE_PROVISIONED = Secure.DEVICE_PROVISIONED;
1929
1930 /**
1931 * @deprecated Use {@link android.provider.Settings.Secure#HTTP_PROXY} instead
1932 */
1933 @Deprecated
1934 public static final String HTTP_PROXY = Secure.HTTP_PROXY;
1935
1936 /**
1937 * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
1938 */
1939 @Deprecated
1940 public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001941
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001942 /**
1943 * @deprecated Use {@link android.provider.Settings.Secure#LOCATION_PROVIDERS_ALLOWED}
1944 * instead
1945 */
1946 @Deprecated
1947 public static final String LOCATION_PROVIDERS_ALLOWED = Secure.LOCATION_PROVIDERS_ALLOWED;
1948
1949 /**
1950 * @deprecated Use {@link android.provider.Settings.Secure#LOGGING_ID} instead
1951 */
1952 @Deprecated
1953 public static final String LOGGING_ID = Secure.LOGGING_ID;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001954
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001955 /**
1956 * @deprecated Use {@link android.provider.Settings.Secure#NETWORK_PREFERENCE} instead
1957 */
1958 @Deprecated
1959 public static final String NETWORK_PREFERENCE = Secure.NETWORK_PREFERENCE;
1960
1961 /**
1962 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_ENABLED}
1963 * instead
1964 */
1965 @Deprecated
1966 public static final String PARENTAL_CONTROL_ENABLED = Secure.PARENTAL_CONTROL_ENABLED;
1967
1968 /**
1969 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_LAST_UPDATE}
1970 * instead
1971 */
1972 @Deprecated
1973 public static final String PARENTAL_CONTROL_LAST_UPDATE = Secure.PARENTAL_CONTROL_LAST_UPDATE;
1974
1975 /**
1976 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_REDIRECT_URL}
1977 * instead
1978 */
1979 @Deprecated
1980 public static final String PARENTAL_CONTROL_REDIRECT_URL =
1981 Secure.PARENTAL_CONTROL_REDIRECT_URL;
1982
1983 /**
1984 * @deprecated Use {@link android.provider.Settings.Secure#SETTINGS_CLASSNAME} instead
1985 */
1986 @Deprecated
1987 public static final String SETTINGS_CLASSNAME = Secure.SETTINGS_CLASSNAME;
1988
1989 /**
1990 * @deprecated Use {@link android.provider.Settings.Secure#USB_MASS_STORAGE_ENABLED} instead
1991 */
1992 @Deprecated
1993 public static final String USB_MASS_STORAGE_ENABLED = Secure.USB_MASS_STORAGE_ENABLED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001994
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001995 /**
1996 * @deprecated Use {@link android.provider.Settings.Secure#USE_GOOGLE_MAIL} instead
1997 */
1998 @Deprecated
1999 public static final String USE_GOOGLE_MAIL = Secure.USE_GOOGLE_MAIL;
2000
Dianne Hackborn4a51c202009-08-21 15:14:02 -07002001 /**
2002 * @deprecated Use
2003 * {@link android.provider.Settings.Secure#WIFI_MAX_DHCP_RETRY_COUNT} instead
2004 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002005 @Deprecated
2006 public static final String WIFI_MAX_DHCP_RETRY_COUNT = Secure.WIFI_MAX_DHCP_RETRY_COUNT;
2007
Dianne Hackborn4a51c202009-08-21 15:14:02 -07002008 /**
2009 * @deprecated Use
2010 * {@link android.provider.Settings.Secure#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
2011 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002012 @Deprecated
2013 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
2014 Secure.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
2015
2016 /**
2017 * @deprecated Use
2018 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON} instead
2019 */
2020 @Deprecated
2021 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
2022 Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
2023
2024 /**
2025 * @deprecated Use
2026 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} instead
2027 */
2028 @Deprecated
2029 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
2030 Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002031
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002032 /**
2033 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_NUM_OPEN_NETWORKS_KEPT}
2034 * instead
2035 */
2036 @Deprecated
2037 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = Secure.WIFI_NUM_OPEN_NETWORKS_KEPT;
2038
2039 /**
2040 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_ON} instead
2041 */
2042 @Deprecated
2043 public static final String WIFI_ON = Secure.WIFI_ON;
2044
2045 /**
2046 * @deprecated Use
2047 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE}
2048 * instead
2049 */
2050 @Deprecated
2051 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
2052 Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE;
2053
2054 /**
2055 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_AP_COUNT} instead
2056 */
2057 @Deprecated
2058 public static final String WIFI_WATCHDOG_AP_COUNT = Secure.WIFI_WATCHDOG_AP_COUNT;
2059
2060 /**
2061 * @deprecated Use
2062 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS} instead
2063 */
2064 @Deprecated
2065 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
2066 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002067
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002068 /**
2069 * @deprecated Use
2070 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED} instead
2071 */
2072 @Deprecated
2073 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
2074 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED;
2075
2076 /**
2077 * @deprecated Use
2078 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS}
2079 * instead
2080 */
2081 @Deprecated
2082 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
2083 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS;
2084
2085 /**
2086 * @deprecated Use
2087 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT} instead
2088 */
2089 @Deprecated
2090 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
2091 Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT;
2092
2093 /**
2094 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_MAX_AP_CHECKS}
2095 * instead
2096 */
2097 @Deprecated
2098 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = Secure.WIFI_WATCHDOG_MAX_AP_CHECKS;
2099
2100 /**
2101 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ON} instead
2102 */
2103 @Deprecated
2104 public static final String WIFI_WATCHDOG_ON = Secure.WIFI_WATCHDOG_ON;
2105
2106 /**
2107 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_COUNT} instead
2108 */
2109 @Deprecated
2110 public static final String WIFI_WATCHDOG_PING_COUNT = Secure.WIFI_WATCHDOG_PING_COUNT;
2111
2112 /**
2113 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_DELAY_MS}
2114 * instead
2115 */
2116 @Deprecated
2117 public static final String WIFI_WATCHDOG_PING_DELAY_MS = Secure.WIFI_WATCHDOG_PING_DELAY_MS;
2118
2119 /**
2120 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_TIMEOUT_MS}
2121 * instead
2122 */
2123 @Deprecated
2124 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS =
2125 Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS;
2126 }
2127
2128 /**
2129 * Secure system settings, containing system preferences that applications
2130 * can read but are not allowed to write. These are for preferences that
2131 * the user must explicitly modify through the system UI or specialized
2132 * APIs for those values, not modified directly by applications.
2133 */
2134 public static final class Secure extends NameValueTable {
2135 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_secure_version";
2136
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08002137 // Populated lazily, guarded by class object:
2138 private static NameValueCache sNameValueCache = null;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002139
2140 /**
2141 * Look up a name in the database.
2142 * @param resolver to access the database with
2143 * @param name to look up in the table
2144 * @return the corresponding value, or null if not present
2145 */
2146 public synchronized static String getString(ContentResolver resolver, String name) {
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08002147 if (sNameValueCache == null) {
2148 sNameValueCache = new NameValueCache(SYS_PROP_SETTING_VERSION, CONTENT_URI,
2149 CALL_METHOD_GET_SECURE);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002150 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08002151 return sNameValueCache.getString(resolver, name);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002152 }
2153
2154 /**
2155 * Store a name/value pair into the database.
2156 * @param resolver to access the database with
2157 * @param name to store
2158 * @param value to associate with the name
2159 * @return true if the value was set, false on database errors
2160 */
2161 public static boolean putString(ContentResolver resolver,
2162 String name, String value) {
2163 return putString(resolver, CONTENT_URI, name, value);
2164 }
2165
2166 /**
2167 * Construct the content URI for a particular name/value pair,
2168 * useful for monitoring changes with a ContentObserver.
2169 * @param name to look up in the table
2170 * @return the corresponding content URI, or null if not present
2171 */
2172 public static Uri getUriFor(String name) {
2173 return getUriFor(CONTENT_URI, name);
2174 }
2175
2176 /**
2177 * Convenience function for retrieving a single secure settings value
2178 * as an integer. Note that internally setting values are always
2179 * stored as strings; this function converts the string to an integer
2180 * for you. The default value will be returned if the setting is
2181 * not defined or not an integer.
2182 *
2183 * @param cr The ContentResolver to access.
2184 * @param name The name of the setting to retrieve.
2185 * @param def Value to return if the setting is not defined.
2186 *
2187 * @return The setting's current value, or 'def' if it is not defined
2188 * or not a valid integer.
2189 */
2190 public static int getInt(ContentResolver cr, String name, int def) {
2191 String v = getString(cr, name);
2192 try {
2193 return v != null ? Integer.parseInt(v) : def;
2194 } catch (NumberFormatException e) {
2195 return def;
2196 }
2197 }
2198
2199 /**
2200 * Convenience function for retrieving a single secure settings value
2201 * as an integer. Note that internally setting values are always
2202 * stored as strings; this function converts the string to an integer
2203 * for you.
2204 * <p>
2205 * This version does not take a default value. If the setting has not
2206 * been set, or the string value is not a number,
2207 * it throws {@link SettingNotFoundException}.
2208 *
2209 * @param cr The ContentResolver to access.
2210 * @param name The name of the setting to retrieve.
2211 *
2212 * @throws SettingNotFoundException Thrown if a setting by the given
2213 * name can't be found or the setting value is not an integer.
2214 *
2215 * @return The setting's current value.
2216 */
2217 public static int getInt(ContentResolver cr, String name)
2218 throws SettingNotFoundException {
2219 String v = getString(cr, name);
2220 try {
2221 return Integer.parseInt(v);
2222 } catch (NumberFormatException e) {
2223 throw new SettingNotFoundException(name);
2224 }
2225 }
2226
2227 /**
2228 * Convenience function for updating a single settings value as an
2229 * integer. This will either create a new entry in the table if the
2230 * given name does not exist, or modify the value of the existing row
2231 * with that name. Note that internally setting values are always
2232 * stored as strings, so this function converts the given value to a
2233 * string before storing it.
2234 *
2235 * @param cr The ContentResolver to access.
2236 * @param name The name of the setting to modify.
2237 * @param value The new value for the setting.
2238 * @return true if the value was set, false on database errors
2239 */
2240 public static boolean putInt(ContentResolver cr, String name, int value) {
2241 return putString(cr, name, Integer.toString(value));
2242 }
2243
2244 /**
2245 * Convenience function for retrieving a single secure settings value
2246 * as a {@code long}. Note that internally setting values are always
2247 * stored as strings; this function converts the string to a {@code long}
2248 * for you. The default value will be returned if the setting is
2249 * not defined or not a {@code long}.
2250 *
2251 * @param cr The ContentResolver to access.
2252 * @param name The name of the setting to retrieve.
2253 * @param def Value to return if the setting is not defined.
2254 *
2255 * @return The setting's current value, or 'def' if it is not defined
2256 * or not a valid {@code long}.
2257 */
2258 public static long getLong(ContentResolver cr, String name, long def) {
2259 String valString = getString(cr, name);
2260 long value;
2261 try {
2262 value = valString != null ? Long.parseLong(valString) : def;
2263 } catch (NumberFormatException e) {
2264 value = def;
2265 }
2266 return value;
2267 }
2268
2269 /**
2270 * Convenience function for retrieving a single secure settings value
2271 * as a {@code long}. Note that internally setting values are always
2272 * stored as strings; this function converts the string to a {@code long}
2273 * for you.
2274 * <p>
2275 * This version does not take a default value. If the setting has not
2276 * been set, or the string value is not a number,
2277 * it throws {@link SettingNotFoundException}.
2278 *
2279 * @param cr The ContentResolver to access.
2280 * @param name The name of the setting to retrieve.
2281 *
2282 * @return The setting's current value.
2283 * @throws SettingNotFoundException Thrown if a setting by the given
2284 * name can't be found or the setting value is not an integer.
2285 */
2286 public static long getLong(ContentResolver cr, String name)
2287 throws SettingNotFoundException {
2288 String valString = getString(cr, name);
2289 try {
2290 return Long.parseLong(valString);
2291 } catch (NumberFormatException e) {
2292 throw new SettingNotFoundException(name);
2293 }
2294 }
2295
2296 /**
2297 * Convenience function for updating a secure settings value as a long
2298 * integer. This will either create a new entry in the table if the
2299 * given name does not exist, or modify the value of the existing row
2300 * with that name. Note that internally setting values are always
2301 * stored as strings, so this function converts the given value to a
2302 * string before storing it.
2303 *
2304 * @param cr The ContentResolver to access.
2305 * @param name The name of the setting to modify.
2306 * @param value The new value for the setting.
2307 * @return true if the value was set, false on database errors
2308 */
2309 public static boolean putLong(ContentResolver cr, String name, long value) {
2310 return putString(cr, name, Long.toString(value));
2311 }
2312
2313 /**
2314 * Convenience function for retrieving a single secure settings value
2315 * as a floating point number. Note that internally setting values are
2316 * always stored as strings; this function converts the string to an
2317 * float for you. The default value will be returned if the setting
2318 * is not defined or not a valid float.
2319 *
2320 * @param cr The ContentResolver to access.
2321 * @param name The name of the setting to retrieve.
2322 * @param def Value to return if the setting is not defined.
2323 *
2324 * @return The setting's current value, or 'def' if it is not defined
2325 * or not a valid float.
2326 */
2327 public static float getFloat(ContentResolver cr, String name, float def) {
2328 String v = getString(cr, name);
2329 try {
2330 return v != null ? Float.parseFloat(v) : def;
2331 } catch (NumberFormatException e) {
2332 return def;
2333 }
2334 }
2335
2336 /**
2337 * Convenience function for retrieving a single secure settings value
2338 * as a float. Note that internally setting values are always
2339 * stored as strings; this function converts the string to a float
2340 * for you.
2341 * <p>
2342 * This version does not take a default value. If the setting has not
2343 * been set, or the string value is not a number,
2344 * it throws {@link SettingNotFoundException}.
2345 *
2346 * @param cr The ContentResolver to access.
2347 * @param name The name of the setting to retrieve.
2348 *
2349 * @throws SettingNotFoundException Thrown if a setting by the given
2350 * name can't be found or the setting value is not a float.
2351 *
2352 * @return The setting's current value.
2353 */
2354 public static float getFloat(ContentResolver cr, String name)
2355 throws SettingNotFoundException {
2356 String v = getString(cr, name);
Brian Muramatsue1d46982010-12-06 17:34:20 -08002357 if (v == null) {
2358 throw new SettingNotFoundException(name);
2359 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002360 try {
2361 return Float.parseFloat(v);
2362 } catch (NumberFormatException e) {
2363 throw new SettingNotFoundException(name);
2364 }
2365 }
2366
2367 /**
2368 * Convenience function for updating a single settings value as a
2369 * floating point number. This will either create a new entry in the
2370 * table if the given name does not exist, or modify the value of the
2371 * existing row with that name. Note that internally setting values
2372 * are always stored as strings, so this function converts the given
2373 * value to a string before storing it.
2374 *
2375 * @param cr The ContentResolver to access.
2376 * @param name The name of the setting to modify.
2377 * @param value The new value for the setting.
2378 * @return true if the value was set, false on database errors
2379 */
2380 public static boolean putFloat(ContentResolver cr, String name, float value) {
2381 return putString(cr, name, Float.toString(value));
2382 }
2383
2384 /**
2385 * The content:// style URL for this table
2386 */
2387 public static final Uri CONTENT_URI =
2388 Uri.parse("content://" + AUTHORITY + "/secure");
2389
2390 /**
2391 * Whether ADB is enabled.
2392 */
2393 public static final String ADB_ENABLED = "adb_enabled";
2394
2395 /**
2396 * Setting to allow mock locations and location provider status to be injected into the
2397 * LocationManager service for testing purposes during application development. These
2398 * locations and status values override actual location and status information generated
2399 * by network, gps, or other location providers.
2400 */
2401 public static final String ALLOW_MOCK_LOCATION = "mock_location";
2402
2403 /**
Doug Zongkerd8893db2010-01-26 12:29:44 -08002404 * A 64-bit number (as a hex string) that is randomly
2405 * generated on the device's first boot and should remain
2406 * constant for the lifetime of the device. (The value may
2407 * change if a factory reset is performed on the device.)
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002408 */
2409 public static final String ANDROID_ID = "android_id";
2410
2411 /**
2412 * Whether bluetooth is enabled/disabled
2413 * 0=disabled. 1=enabled.
2414 */
2415 public static final String BLUETOOTH_ON = "bluetooth_on";
2416
2417 /**
2418 * Get the key that retrieves a bluetooth headset's priority.
2419 * @hide
2420 */
2421 public static final String getBluetoothHeadsetPriorityKey(String address) {
2422 return ("bluetooth_headset_priority_" + address.toUpperCase());
2423 }
2424
2425 /**
2426 * Get the key that retrieves a bluetooth a2dp sink's priority.
2427 * @hide
2428 */
2429 public static final String getBluetoothA2dpSinkPriorityKey(String address) {
2430 return ("bluetooth_a2dp_sink_priority_" + address.toUpperCase());
2431 }
2432
2433 /**
Jaikumar Ganesh545e6702010-06-04 10:23:03 -07002434 * Get the key that retrieves a bluetooth Input Device's priority.
2435 * @hide
2436 */
2437 public static final String getBluetoothInputDevicePriorityKey(String address) {
2438 return ("bluetooth_input_device_priority_" + address.toUpperCase());
2439 }
2440
2441 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002442 * Whether or not data roaming is enabled. (0 = false, 1 = true)
2443 */
2444 public static final String DATA_ROAMING = "data_roaming";
2445
2446 /**
2447 * Setting to record the input method used by default, holding the ID
2448 * of the desired method.
2449 */
2450 public static final String DEFAULT_INPUT_METHOD = "default_input_method";
2451
2452 /**
satokab751aa2010-09-14 19:17:36 +09002453 * Setting to record the input method subtype used by default, holding the ID
2454 * of the desired method.
2455 */
2456 public static final String SELECTED_INPUT_METHOD_SUBTYPE =
2457 "selected_input_method_subtype";
2458
2459 /**
satok723a27e2010-11-11 14:58:11 +09002460 * Setting to record the history of input method subtype, holding the pair of ID of IME
2461 * and its last used subtype.
2462 * @hide
2463 */
2464 public static final String INPUT_METHODS_SUBTYPE_HISTORY =
2465 "input_methods_subtype_history";
2466
2467 /**
satok5c58dfc2010-12-14 21:54:47 +09002468 * Setting to record the visibility of input method selector
2469 */
2470 public static final String INPUT_METHOD_SELECTOR_VISIBILITY =
2471 "input_method_selector_visibility";
2472
2473 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002474 * Whether the device has been provisioned (0 = false, 1 = true)
2475 */
2476 public static final String DEVICE_PROVISIONED = "device_provisioned";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002477
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002478 /**
2479 * List of input methods that are currently enabled. This is a string
2480 * containing the IDs of all enabled input methods, each ID separated
2481 * by ':'.
2482 */
2483 public static final String ENABLED_INPUT_METHODS = "enabled_input_methods";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002484
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002485 /**
Amith Yamasanie861ec12010-03-24 21:39:27 -07002486 * List of system input methods that are currently disabled. This is a string
2487 * containing the IDs of all disabled input methods, each ID separated
2488 * by ':'.
2489 * @hide
2490 */
2491 public static final String DISABLED_SYSTEM_INPUT_METHODS = "disabled_system_input_methods";
2492
2493 /**
Robert Greenwalt434203a2010-10-11 16:00:27 -07002494 * Host name and port for global http proxy. Uses ':' seperator for between host and port
2495 * TODO - deprecate in favor of global_http_proxy_host, etc
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002496 */
2497 public static final String HTTP_PROXY = "http_proxy";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002498
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002499 /**
Robert Greenwalt434203a2010-10-11 16:00:27 -07002500 * Host name for global http proxy. Set via ConnectivityManager.
2501 * @hide
2502 */
2503 public static final String GLOBAL_HTTP_PROXY_HOST = "global_http_proxy_host";
2504
2505 /**
2506 * Integer host port for global http proxy. Set via ConnectivityManager.
2507 * @hide
2508 */
2509 public static final String GLOBAL_HTTP_PROXY_PORT = "global_http_proxy_port";
2510
2511 /**
Oscar Montemayor16fb7912010-08-02 09:38:48 -07002512 * Exclusion list for global proxy. This string contains a list of comma-separated
2513 * domains where the global proxy does not apply. Domains should be listed in a comma-
2514 * separated list. Example of acceptable formats: ".domain1.com,my.domain2.com"
Robert Greenwalt434203a2010-10-11 16:00:27 -07002515 * Use ConnectivityManager to set/get.
Oscar Montemayor16fb7912010-08-02 09:38:48 -07002516 * @hide
2517 */
Robert Greenwalt434203a2010-10-11 16:00:27 -07002518 public static final String GLOBAL_HTTP_PROXY_EXCLUSION_LIST =
2519 "global_http_proxy_exclusion_list";
Oscar Montemayor16fb7912010-08-02 09:38:48 -07002520
2521 /**
2522 * Enables the UI setting to allow the user to specify the global HTTP proxy
2523 * and associated exclusion list.
2524 * @hide
2525 */
2526 public static final String SET_GLOBAL_HTTP_PROXY = "set_global_http_proxy";
2527
2528 /**
Robert Greenwalte90aa5e2010-09-01 11:34:05 -07002529 * Setting for default DNS in case nobody suggests one
2530 * @hide
2531 */
2532 public static final String DEFAULT_DNS_SERVER = "default_dns_server";
2533
2534 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002535 * Whether the package installer should allow installation of apps downloaded from
2536 * sources other than the Android Market (vending machine).
2537 *
2538 * 1 = allow installing from other sources
2539 * 0 = only allow installing from the Android Market
2540 */
2541 public static final String INSTALL_NON_MARKET_APPS = "install_non_market_apps";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002542
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002543 /**
2544 * Comma-separated list of location providers that activities may access.
2545 */
2546 public static final String LOCATION_PROVIDERS_ALLOWED = "location_providers_allowed";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002547
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002548 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08002549 * Whether autolock is enabled (0 = false, 1 = true)
2550 */
2551 public static final String LOCK_PATTERN_ENABLED = "lock_pattern_autolock";
2552
2553 /**
2554 * Whether lock pattern is visible as user enters (0 = false, 1 = true)
2555 */
2556 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
2557
2558 /**
2559 * Whether lock pattern will vibrate as user enters (0 = false, 1 = true)
2560 */
2561 public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
2562 "lock_pattern_tactile_feedback_enabled";
2563
2564 /**
Jim Millerbc4603b2010-08-30 21:21:34 -07002565 * This preference allows the device to be locked given time after screen goes off,
2566 * subject to current DeviceAdmin policy limits.
2567 * @hide
2568 */
2569 public static final String LOCK_SCREEN_LOCK_AFTER_TIMEOUT = "lock_screen_lock_after_timeout";
2570
2571
2572 /**
Jim Miller253a5ef2010-10-13 20:57:29 -07002573 * This preference contains the string that shows for owner info on LockScren.
2574 * @hide
2575 */
2576 public static final String LOCK_SCREEN_OWNER_INFO = "lock_screen_owner_info";
2577
2578 /**
2579 * This preference enables showing the owner info on LockScren.
2580 * @hide
2581 */
2582 public static final String LOCK_SCREEN_OWNER_INFO_ENABLED =
2583 "lock_screen_owner_info_enabled";
2584
2585 /**
Joe Onorato571ae902011-05-24 13:48:43 -07002586 * The saved value for WindowManagerService.setForcedDisplaySize().
2587 * Two integers separated by a comma. If unset, then use the real display size.
2588 * @hide
2589 */
2590 public static final String DISPLAY_SIZE_FORCED = "display_size_forced";
2591
2592 /**
Mike Lockwoodbcab8df2009-06-25 16:39:09 -04002593 * Whether assisted GPS should be enabled or not.
2594 * @hide
2595 */
2596 public static final String ASSISTED_GPS_ENABLED = "assisted_gps_enabled";
2597
2598 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002599 * The Logging ID (a unique 64-bit value) as a hex string.
2600 * Used as a pseudonymous identifier for logging.
2601 * @deprecated This identifier is poorly initialized and has
2602 * many collisions. It should not be used.
2603 */
2604 @Deprecated
2605 public static final String LOGGING_ID = "logging_id";
2606
2607 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002608 * User preference for which network(s) should be used. Only the
2609 * connectivity service should touch this.
2610 */
2611 public static final String NETWORK_PREFERENCE = "network_preference";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002612
2613 /**
Robert Greenwalt2a091d72010-02-11 18:18:40 -08002614 * Used to disable Tethering on a device - defaults to true
2615 * @hide
2616 */
2617 public static final String TETHER_SUPPORTED = "tether_supported";
2618
2619 /**
Robert Greenwalt77b32dd2010-06-03 18:57:26 -07002620 * Used to require DUN APN on the device or not - defaults to a build config value
2621 * which defaults to false
2622 * @hide
2623 */
2624 public static final String TETHER_DUN_REQUIRED = "tether_dun_required";
2625
2626 /**
2627 * Used to hold a gservices-provisioned apn value for DUN. If set, or the
2628 * corresponding build config values are set it will override the APN DB
2629 * values.
2630 * Consists of a comma seperated list of strings:
2631 * "name,apn,proxy,port,username,password,server,mmsc,mmsproxy,mmsport,mcc,mnc,auth,type"
2632 * note that empty fields can be ommitted: "name,apn,,,,,,,,,310,260,,DUN"
2633 * @hide
2634 */
2635 public static final String TETHER_DUN_APN = "tether_dun_apn";
2636
2637 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002638 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002639 */
2640 public static final String PARENTAL_CONTROL_ENABLED = "parental_control_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002641
2642 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002643 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002644 */
2645 public static final String PARENTAL_CONTROL_LAST_UPDATE = "parental_control_last_update";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002646
2647 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002648 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002649 */
2650 public static final String PARENTAL_CONTROL_REDIRECT_URL = "parental_control_redirect_url";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002651
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002652 /**
Brad Fitzpatrickd7ad0d22010-12-02 15:30:23 -08002653 * A positive value indicates how often the SamplingProfiler
2654 * should take snapshots. Zero value means SamplingProfiler
2655 * is disabled.
Sen Hubde75702010-05-28 01:54:03 -07002656 *
2657 * @hide
2658 */
Brad Fitzpatrickd7ad0d22010-12-02 15:30:23 -08002659 public static final String SAMPLING_PROFILER_MS = "sampling_profiler_ms";
Sen Hubde75702010-05-28 01:54:03 -07002660
2661 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002662 * Settings classname to launch when Settings is clicked from All
2663 * Applications. Needed because of user testing between the old
2664 * and new Settings apps.
2665 */
2666 // TODO: 881807
2667 public static final String SETTINGS_CLASSNAME = "settings_classname";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002668
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002669 /**
2670 * USB Mass Storage Enabled
2671 */
2672 public static final String USB_MASS_STORAGE_ENABLED = "usb_mass_storage_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002673
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002674 /**
2675 * If this setting is set (to anything), then all references
2676 * to Gmail on the device must change to Google Mail.
2677 */
2678 public static final String USE_GOOGLE_MAIL = "use_google_mail";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002679
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002680 /**
svetoslavganov75986cf2009-05-14 22:28:01 -07002681 * If accessibility is enabled.
2682 */
2683 public static final String ACCESSIBILITY_ENABLED = "accessibility_enabled";
2684
2685 /**
2686 * List of the enabled accessibility providers.
2687 */
2688 public static final String ENABLED_ACCESSIBILITY_SERVICES =
2689 "enabled_accessibility_services";
2690
2691 /**
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07002692 * If injection of accessibility enhancing JavaScript scripts
2693 * is enabled.
2694 * <p>
2695 * Note: Accessibility injecting scripts are served by the
2696 * Google infrastructure and enable users with disabilities to
2697 * efficiantly navigate in and explore web content.
2698 * </p>
2699 * <p>
2700 * This property represents a boolean value.
2701 * </p>
2702 * @hide
2703 */
2704 public static final String ACCESSIBILITY_SCRIPT_INJECTION =
2705 "accessibility_script_injection";
2706
2707 /**
2708 * Key bindings for navigation in built-in accessibility support for web content.
2709 * <p>
2710 * Note: These key bindings are for the built-in accessibility navigation for
2711 * web content which is used as a fall back solution if JavaScript in a WebView
2712 * is not enabled or the user has not opted-in script injection from Google.
2713 * </p>
2714 * <p>
2715 * The bindings are separated by semi-colon. A binding is a mapping from
2716 * a key to a sequence of actions (for more details look at
2717 * android.webkit.AccessibilityInjector). A key is represented as the hexademical
2718 * string representation of an integer obtained from a meta state (optional) shifted
2719 * sixteen times left and bitwise ored with a key code. An action is represented
2720 * as a hexademical string representation of an integer where the first two digits
2721 * are navigation action index, the second, the third, and the fourth digit pairs
2722 * represent the action arguments. The separate actions in a binding are colon
2723 * separated. The key and the action sequence it maps to are separated by equals.
2724 * </p>
2725 * <p>
2726 * For example, the binding below maps the DPAD right button to traverse the
2727 * current navigation axis once without firing an accessibility event and to
2728 * perform the same traversal again but to fire an event:
2729 * <code>
2730 * 0x16=0x01000100:0x01000101;
2731 * </code>
2732 * </p>
2733 * <p>
2734 * The goal of this binding is to enable dynamic rebinding of keys to
2735 * navigation actions for web content without requiring a framework change.
2736 * </p>
2737 * <p>
2738 * This property represents a string value.
2739 * </p>
2740 * @hide
2741 */
2742 public static final String ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS =
2743 "accessibility_web_content_key_bindings";
2744
2745 /**
Svetoslav Ganov54d068e2011-03-02 12:58:40 -08002746 * The timout for considering a press to be a long press in milliseconds.
2747 * @hide
2748 */
2749 public static final String LONG_PRESS_TIMEOUT = "long_press_timeout";
2750
2751 /**
Jean-Michel Trivif62ba452009-06-04 14:55:24 -07002752 * Setting to always use the default text-to-speech settings regardless
2753 * of the application settings.
2754 * 1 = override application settings,
2755 * 0 = use application settings (if specified).
2756 */
2757 public static final String TTS_USE_DEFAULTS = "tts_use_defaults";
2758
2759 /**
2760 * Default text-to-speech engine speech rate. 100 = 1x
2761 */
2762 public static final String TTS_DEFAULT_RATE = "tts_default_rate";
2763
2764 /**
2765 * Default text-to-speech engine pitch. 100 = 1x
2766 */
2767 public static final String TTS_DEFAULT_PITCH = "tts_default_pitch";
2768
2769 /**
2770 * Default text-to-speech engine.
2771 */
2772 public static final String TTS_DEFAULT_SYNTH = "tts_default_synth";
2773
2774 /**
Jean-Michel Trivif4782672009-06-09 16:22:48 -07002775 * Default text-to-speech language.
2776 */
2777 public static final String TTS_DEFAULT_LANG = "tts_default_lang";
2778
2779 /**
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07002780 * Default text-to-speech country.
2781 */
2782 public static final String TTS_DEFAULT_COUNTRY = "tts_default_country";
2783
2784 /**
2785 * Default text-to-speech locale variant.
2786 */
2787 public static final String TTS_DEFAULT_VARIANT = "tts_default_variant";
2788
2789 /**
Charles Chenceffa152010-03-16 21:18:10 -07002790 * Space delimited list of plugin packages that are enabled.
2791 */
2792 public static final String TTS_ENABLED_PLUGINS = "tts_enabled_plugins";
2793
2794 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002795 * Whether to notify the user of open networks.
2796 * <p>
2797 * If not connected and the scan results have an open network, we will
2798 * put this notification up. If we attempt to connect to a network or
2799 * the open network(s) disappear, we remove the notification. When we
2800 * show the notification, we will not show it again for
2801 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} time.
2802 */
2803 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
2804 "wifi_networks_available_notification_on";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002805
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002806 /**
2807 * Delay (in seconds) before repeating the Wi-Fi networks available notification.
2808 * Connecting to a network will reset the timer.
2809 */
2810 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
2811 "wifi_networks_available_repeat_delay";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002812
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002813 /**
Irfan Sheriffed4f28b2010-10-29 15:32:10 -07002814 * 802.11 country code in ISO 3166 format
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002815 * @hide
2816 */
Irfan Sheriffed4f28b2010-10-29 15:32:10 -07002817 public static final String WIFI_COUNTRY_CODE = "wifi_country_code";
2818
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002819
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002820 /**
2821 * When the number of open networks exceeds this number, the
2822 * least-recently-used excess networks will be removed.
2823 */
2824 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = "wifi_num_open_networks_kept";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002825
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002826 /**
2827 * Whether the Wi-Fi should be on. Only the Wi-Fi service should touch this.
2828 */
2829 public static final String WIFI_ON = "wifi_on";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002830
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002831 /**
Irfan Sheriffa3bd4092010-03-24 17:58:59 -07002832 * Used to save the Wifi_ON state prior to tethering.
2833 * This state will be checked to restore Wifi after
2834 * the user turns off tethering.
Irfan Sheriff5321aef2010-02-12 12:35:59 -08002835 *
2836 * @hide
2837 */
Irfan Sheriffa3bd4092010-03-24 17:58:59 -07002838 public static final String WIFI_SAVED_STATE = "wifi_saved_state";
Irfan Sheriff5321aef2010-02-12 12:35:59 -08002839
2840 /**
Irfan Sheriff9ab518ad2010-03-12 15:48:17 -08002841 * AP SSID
2842 *
2843 * @hide
2844 */
2845 public static final String WIFI_AP_SSID = "wifi_ap_ssid";
2846
2847 /**
2848 * AP security
2849 *
2850 * @hide
2851 */
2852 public static final String WIFI_AP_SECURITY = "wifi_ap_security";
2853
2854 /**
2855 * AP passphrase
2856 *
2857 * @hide
2858 */
2859 public static final String WIFI_AP_PASSWD = "wifi_ap_passwd";
2860
2861 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002862 * The acceptable packet loss percentage (range 0 - 100) before trying
2863 * another AP on the same network.
2864 */
2865 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
2866 "wifi_watchdog_acceptable_packet_loss_percentage";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002867
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002868 /**
2869 * The number of access points required for a network in order for the
2870 * watchdog to monitor it.
2871 */
2872 public static final String WIFI_WATCHDOG_AP_COUNT = "wifi_watchdog_ap_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002873
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002874 /**
2875 * The delay between background checks.
2876 */
2877 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
2878 "wifi_watchdog_background_check_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002879
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002880 /**
2881 * Whether the Wi-Fi watchdog is enabled for background checking even
2882 * after it thinks the user has connected to a good access point.
2883 */
2884 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
2885 "wifi_watchdog_background_check_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002886
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002887 /**
2888 * The timeout for a background ping
2889 */
2890 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
2891 "wifi_watchdog_background_check_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002892
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002893 /**
2894 * The number of initial pings to perform that *may* be ignored if they
2895 * fail. Again, if these fail, they will *not* be used in packet loss
2896 * calculation. For example, one network always seemed to time out for
2897 * the first couple pings, so this is set to 3 by default.
2898 */
2899 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
2900 "wifi_watchdog_initial_ignored_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002901
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002902 /**
2903 * The maximum number of access points (per network) to attempt to test.
2904 * If this number is reached, the watchdog will no longer monitor the
2905 * initial connection state for the network. This is a safeguard for
2906 * networks containing multiple APs whose DNS does not respond to pings.
2907 */
2908 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = "wifi_watchdog_max_ap_checks";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002909
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002910 /**
2911 * Whether the Wi-Fi watchdog is enabled.
2912 */
2913 public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
2914
2915 /**
2916 * A comma-separated list of SSIDs for which the Wi-Fi watchdog should be enabled.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002917 */
2918 public static final String WIFI_WATCHDOG_WATCH_LIST = "wifi_watchdog_watch_list";
2919
2920 /**
2921 * The number of pings to test if an access point is a good connection.
2922 */
2923 public static final String WIFI_WATCHDOG_PING_COUNT = "wifi_watchdog_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002924
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002925 /**
2926 * The delay between pings.
2927 */
2928 public static final String WIFI_WATCHDOG_PING_DELAY_MS = "wifi_watchdog_ping_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002929
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002930 /**
2931 * The timeout per ping.
2932 */
2933 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS = "wifi_watchdog_ping_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002934
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002935 /**
Irfan Sheriff5ea65d62011-06-05 21:29:56 -07002936 * Setting to turn off walled garden test on Wi-Fi. Feature is enabled by default and
2937 * the setting needs to be set to 0 to disable it.
2938 * @hide
2939 */
2940 public static final String WIFI_WATCHDOG_WALLED_GARDEN_TEST_ENABLED =
2941 "wifi_watchdog_walled_garden_test_enabled";
2942
2943 /**
2944 * The URL used for walled garden check upon a new conection. WifiWatchdogService
2945 * fetches the URL and checks to see if {@link #WIFI_WATCHDOG_WALLED_GARDEN_PATTERN}
2946 * is not part of the title string to notify the user on the presence of a walled garden.
2947 * @hide
2948 */
2949 public static final String WIFI_WATCHDOG_WALLED_GARDEN_URL =
2950 "wifi_watchdog_walled_garden_url";
2951
2952 /**
2953 * The pattern string in the fetched URL used to detect a walled garden
2954 * @hide
2955 */
2956 public static final String WIFI_WATCHDOG_WALLED_GARDEN_PATTERN =
2957 "wifi_watchdog_walled_garden_pattern";
2958
2959 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002960 * The maximum number of times we will retry a connection to an access
2961 * point for which we have failed in acquiring an IP address from DHCP.
2962 * A value of N means that we will make N+1 connection attempts in all.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002963 */
2964 public static final String WIFI_MAX_DHCP_RETRY_COUNT = "wifi_max_dhcp_retry_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002965
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002966 /**
Irfan Sheriff36f74132010-11-04 16:57:37 -07002967 * The operational wifi frequency band
2968 * Set to one of {@link WifiManager#WIFI_FREQUENCY_BAND_AUTO},
2969 * {@link WifiManager#WIFI_FREQUENCY_BAND_5GHZ} or
2970 * {@link WifiManager#WIFI_FREQUENCY_BAND_2GHZ}
2971 *
2972 * @hide
2973 */
2974 public static final String WIFI_FREQUENCY_BAND = "wifi_frequency_band";
2975
2976 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002977 * Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile
2978 * data connectivity to be established after a disconnect from Wi-Fi.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002979 */
2980 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
2981 "wifi_mobile_data_transition_wakelock_timeout_ms";
2982
2983 /**
2984 * Whether background data usage is allowed by the user. See
2985 * ConnectivityManager for more info.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002986 */
2987 public static final String BACKGROUND_DATA = "background_data";
Wink Saville04e71b32009-04-02 11:00:54 -07002988
2989 /**
Bjorn Bringert98bfa392010-03-24 10:59:48 +00002990 * Origins for which browsers should allow geolocation by default.
2991 * The value is a space-separated list of origins.
2992 */
2993 public static final String ALLOWED_GEOLOCATION_ORIGINS
2994 = "allowed_geolocation_origins";
2995
2996 /**
Robert Greenwaltc03fa502010-02-23 18:58:05 -08002997 * Whether mobile data connections are allowed by the user. See
2998 * ConnectivityManager for more info.
2999 * @hide
3000 */
3001 public static final String MOBILE_DATA = "mobile_data";
3002
3003 /**
Wink Saville04e71b32009-04-02 11:00:54 -07003004 * The CDMA roaming mode 0 = Home Networks, CDMA default
3005 * 1 = Roaming on Affiliated networks
3006 * 2 = Roaming on any networks
3007 * @hide
3008 */
3009 public static final String CDMA_ROAMING_MODE = "roaming_settings";
3010
3011 /**
3012 * The CDMA subscription mode 0 = RUIM/SIM (default)
3013 * 1 = NV
3014 * @hide
3015 */
3016 public static final String CDMA_SUBSCRIPTION_MODE = "subscription_mode";
3017
3018 /**
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003019 * The preferred network mode 7 = Global
3020 * 6 = EvDo only
3021 * 5 = CDMA w/o EvDo
3022 * 4 = CDMA / EvDo auto
3023 * 3 = GSM / WCDMA auto
3024 * 2 = WCDMA only
3025 * 1 = GSM only
3026 * 0 = GSM / WCDMA preferred
Wink Saville04e71b32009-04-02 11:00:54 -07003027 * @hide
3028 */
3029 public static final String PREFERRED_NETWORK_MODE =
3030 "preferred_network_mode";
3031
3032 /**
Wink Savillee9b06d72009-05-18 21:47:50 -07003033 * The preferred TTY mode 0 = TTy Off, CDMA default
3034 * 1 = TTY Full
3035 * 2 = TTY HCO
3036 * 3 = TTY VCO
3037 * @hide
3038 */
3039 public static final String PREFERRED_TTY_MODE =
3040 "preferred_tty_mode";
3041
3042
3043 /**
Wink Saville04e71b32009-04-02 11:00:54 -07003044 * CDMA Cell Broadcast SMS
3045 * 0 = CDMA Cell Broadcast SMS disabled
3046 * 1 = CDMA Cell Broadcast SMS enabled
3047 * @hide
3048 */
3049 public static final String CDMA_CELL_BROADCAST_SMS =
3050 "cdma_cell_broadcast_sms";
3051
3052 /**
3053 * The cdma subscription 0 = Subscription from RUIM, when available
3054 * 1 = Subscription from NV
3055 * @hide
3056 */
3057 public static final String PREFERRED_CDMA_SUBSCRIPTION =
3058 "preferred_cdma_subscription";
3059
3060 /**
3061 * Whether the enhanced voice privacy mode is enabled.
3062 * 0 = normal voice privacy
3063 * 1 = enhanced voice privacy
3064 * @hide
3065 */
3066 public static final String ENHANCED_VOICE_PRIVACY_ENABLED = "enhanced_voice_privacy_enabled";
3067
3068 /**
3069 * Whether the TTY mode mode is enabled.
3070 * 0 = disabled
3071 * 1 = enabled
3072 * @hide
3073 */
3074 public static final String TTY_MODE_ENABLED = "tty_mode_enabled";
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003075
3076 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07003077 * Controls whether settings backup is enabled.
Dianne Hackborncf098292009-07-01 19:55:20 -07003078 * Type: int ( 0 = disabled, 1 = enabled )
3079 * @hide
3080 */
3081 public static final String BACKUP_ENABLED = "backup_enabled";
3082
3083 /**
Christopher Tatecce9da52010-02-03 15:11:15 -08003084 * Controls whether application data is automatically restored from backup
3085 * at install time.
3086 * Type: int ( 0 = disabled, 1 = enabled )
3087 * @hide
3088 */
3089 public static final String BACKUP_AUTO_RESTORE = "backup_auto_restore";
3090
3091 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07003092 * Indicates whether settings backup has been fully provisioned.
3093 * Type: int ( 0 = unprovisioned, 1 = fully provisioned )
3094 * @hide
3095 */
3096 public static final String BACKUP_PROVISIONED = "backup_provisioned";
3097
3098 /**
Dianne Hackborncf098292009-07-01 19:55:20 -07003099 * Component of the transport to use for backup/restore.
3100 * @hide
3101 */
3102 public static final String BACKUP_TRANSPORT = "backup_transport";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07003103
Dianne Hackbornd7cd29d2009-07-01 11:22:45 -07003104 /**
3105 * Version for which the setup wizard was last shown. Bumped for
3106 * each release when there is new setup information to show.
3107 * @hide
3108 */
3109 public static final String LAST_SETUP_SHOWN = "last_setup_shown";
Dianne Hackborncf098292009-07-01 19:55:20 -07003110
3111 /**
Doug Zongkerf6888892010-01-06 16:38:14 -08003112 * How frequently (in seconds) to check the memory status of the
3113 * device.
3114 * @hide
3115 */
3116 public static final String MEMCHECK_INTERVAL = "memcheck_interval";
3117
3118 /**
3119 * Max frequency (in seconds) to log memory check stats, in realtime
3120 * seconds. This allows for throttling of logs when the device is
3121 * running for large amounts of time.
3122 * @hide
3123 */
3124 public static final String MEMCHECK_LOG_REALTIME_INTERVAL =
3125 "memcheck_log_realtime_interval";
3126
3127 /**
3128 * Boolean indicating whether rebooting due to system memory checks
3129 * is enabled.
3130 * @hide
3131 */
3132 public static final String MEMCHECK_SYSTEM_ENABLED = "memcheck_system_enabled";
3133
3134 /**
3135 * How many bytes the system process must be below to avoid scheduling
3136 * a soft reboot. This reboot will happen when it is next determined
3137 * to be a good time.
3138 * @hide
3139 */
3140 public static final String MEMCHECK_SYSTEM_SOFT_THRESHOLD = "memcheck_system_soft";
3141
3142 /**
3143 * How many bytes the system process must be below to avoid scheduling
3144 * a hard reboot. This reboot will happen immediately.
3145 * @hide
3146 */
3147 public static final String MEMCHECK_SYSTEM_HARD_THRESHOLD = "memcheck_system_hard";
3148
3149 /**
3150 * How many bytes the phone process must be below to avoid scheduling
3151 * a soft restart. This restart will happen when it is next determined
3152 * to be a good time.
3153 * @hide
3154 */
3155 public static final String MEMCHECK_PHONE_SOFT_THRESHOLD = "memcheck_phone_soft";
3156
3157 /**
3158 * How many bytes the phone process must be below to avoid scheduling
3159 * a hard restart. This restart will happen immediately.
3160 * @hide
3161 */
3162 public static final String MEMCHECK_PHONE_HARD_THRESHOLD = "memcheck_phone_hard";
3163
3164 /**
3165 * Boolean indicating whether restarting the phone process due to
3166 * memory checks is enabled.
3167 * @hide
3168 */
3169 public static final String MEMCHECK_PHONE_ENABLED = "memcheck_phone_enabled";
3170
3171 /**
3172 * First time during the day it is okay to kill processes
3173 * or reboot the device due to low memory situations. This number is
3174 * in seconds since midnight.
3175 * @hide
3176 */
3177 public static final String MEMCHECK_EXEC_START_TIME = "memcheck_exec_start_time";
3178
3179 /**
3180 * Last time during the day it is okay to kill processes
3181 * or reboot the device due to low memory situations. This number is
3182 * in seconds since midnight.
3183 * @hide
3184 */
3185 public static final String MEMCHECK_EXEC_END_TIME = "memcheck_exec_end_time";
3186
3187 /**
3188 * How long the screen must have been off in order to kill processes
3189 * or reboot. This number is in seconds. A value of -1 means to
3190 * entirely disregard whether the screen is on.
3191 * @hide
3192 */
3193 public static final String MEMCHECK_MIN_SCREEN_OFF = "memcheck_min_screen_off";
3194
3195 /**
3196 * How much time there must be until the next alarm in order to kill processes
3197 * or reboot. This number is in seconds. Note: this value must be
3198 * smaller than {@link #MEMCHECK_RECHECK_INTERVAL} or else it will
3199 * always see an alarm scheduled within its time.
3200 * @hide
3201 */
3202 public static final String MEMCHECK_MIN_ALARM = "memcheck_min_alarm";
3203
3204 /**
3205 * How frequently to check whether it is a good time to restart things,
3206 * if the device is in a bad state. This number is in seconds. Note:
3207 * this value must be larger than {@link #MEMCHECK_MIN_ALARM} or else
3208 * the alarm to schedule the recheck will always appear within the
3209 * minimum "do not execute now" time.
3210 * @hide
3211 */
3212 public static final String MEMCHECK_RECHECK_INTERVAL = "memcheck_recheck_interval";
3213
3214 /**
3215 * How frequently (in DAYS) to reboot the device. If 0, no reboots
3216 * will occur.
3217 * @hide
3218 */
3219 public static final String REBOOT_INTERVAL = "reboot_interval";
3220
3221 /**
3222 * First time during the day it is okay to force a reboot of the
3223 * device (if REBOOT_INTERVAL is set). This number is
3224 * in seconds since midnight.
3225 * @hide
3226 */
3227 public static final String REBOOT_START_TIME = "reboot_start_time";
3228
3229 /**
3230 * The window of time (in seconds) after each REBOOT_INTERVAL in which
3231 * a reboot can be executed. If 0, a reboot will always be executed at
3232 * exactly the given time. Otherwise, it will only be executed if
3233 * the device is idle within the window.
3234 * @hide
3235 */
3236 public static final String REBOOT_WINDOW = "reboot_window";
3237
3238 /**
Doug Zongker43866e02010-01-07 12:09:54 -08003239 * Threshold values for the duration and level of a discharge cycle, under
3240 * which we log discharge cycle info.
3241 * @hide
3242 */
3243 public static final String BATTERY_DISCHARGE_DURATION_THRESHOLD =
3244 "battery_discharge_duration_threshold";
3245 /** @hide */
3246 public static final String BATTERY_DISCHARGE_THRESHOLD = "battery_discharge_threshold";
3247
3248 /**
3249 * Flag for allowing ActivityManagerService to send ACTION_APP_ERROR intents
3250 * on application crashes and ANRs. If this is disabled, the crash/ANR dialog
3251 * will never display the "Report" button.
3252 * Type: int ( 0 = disallow, 1 = allow )
3253 * @hide
3254 */
3255 public static final String SEND_ACTION_APP_ERROR = "send_action_app_error";
3256
3257 /**
3258 * Nonzero causes Log.wtf() to crash.
3259 * @hide
3260 */
3261 public static final String WTF_IS_FATAL = "wtf_is_fatal";
3262
3263 /**
Jake Hambybb371632010-08-23 18:16:48 -07003264 * Maximum age of entries kept by {@link com.android.internal.os.IDropBoxManagerService}.
Doug Zongker43866e02010-01-07 12:09:54 -08003265 * @hide
3266 */
3267 public static final String DROPBOX_AGE_SECONDS =
3268 "dropbox_age_seconds";
3269 /**
Jake Hambybb371632010-08-23 18:16:48 -07003270 * Maximum number of entry files which {@link com.android.internal.os.IDropBoxManagerService} will keep around.
Dan Egnor3a8b0c12010-03-24 17:48:20 -07003271 * @hide
3272 */
3273 public static final String DROPBOX_MAX_FILES =
3274 "dropbox_max_files";
3275 /**
Jake Hambybb371632010-08-23 18:16:48 -07003276 * Maximum amount of disk space used by {@link com.android.internal.os.IDropBoxManagerService} no matter what.
Doug Zongker43866e02010-01-07 12:09:54 -08003277 * @hide
3278 */
3279 public static final String DROPBOX_QUOTA_KB =
3280 "dropbox_quota_kb";
3281 /**
Jake Hambybb371632010-08-23 18:16:48 -07003282 * Percent of free disk (excluding reserve) which {@link com.android.internal.os.IDropBoxManagerService} will use.
Doug Zongker43866e02010-01-07 12:09:54 -08003283 * @hide
3284 */
3285 public static final String DROPBOX_QUOTA_PERCENT =
3286 "dropbox_quota_percent";
3287 /**
Jake Hambybb371632010-08-23 18:16:48 -07003288 * Percent of total disk which {@link com.android.internal.os.IDropBoxManagerService} will never dip into.
Doug Zongker43866e02010-01-07 12:09:54 -08003289 * @hide
3290 */
3291 public static final String DROPBOX_RESERVE_PERCENT =
3292 "dropbox_reserve_percent";
3293 /**
3294 * Prefix for per-tag dropbox disable/enable settings.
3295 * @hide
3296 */
3297 public static final String DROPBOX_TAG_PREFIX =
3298 "dropbox:";
Dan Egnora455d192010-03-12 08:52:28 -08003299 /**
3300 * Lines of logcat to include with system crash/ANR/etc. reports,
3301 * as a prefix of the dropbox tag of the report type.
3302 * For example, "logcat_for_system_server_anr" controls the lines
3303 * of logcat captured with system server ANR reports. 0 to disable.
3304 * @hide
3305 */
3306 public static final String ERROR_LOGCAT_PREFIX =
3307 "logcat_for_";
Doug Zongker43866e02010-01-07 12:09:54 -08003308
3309
3310 /**
3311 * Screen timeout in milliseconds corresponding to the
3312 * PowerManager's POKE_LOCK_SHORT_TIMEOUT flag (i.e. the fastest
3313 * possible screen timeout behavior.)
3314 * @hide
3315 */
3316 public static final String SHORT_KEYLIGHT_DELAY_MS =
3317 "short_keylight_delay_ms";
3318
3319 /**
3320 * The interval in minutes after which the amount of free storage left on the
3321 * device is logged to the event log
3322 * @hide
3323 */
3324 public static final String SYS_FREE_STORAGE_LOG_INTERVAL =
3325 "sys_free_storage_log_interval";
3326
3327 /**
3328 * Threshold for the amount of change in disk free space required to report the amount of
3329 * free space. Used to prevent spamming the logs when the disk free space isn't changing
3330 * frequently.
3331 * @hide
3332 */
3333 public static final String DISK_FREE_CHANGE_REPORTING_THRESHOLD =
3334 "disk_free_change_reporting_threshold";
3335
3336
3337 /**
3338 * Minimum percentage of free storage on the device that is used to determine if
Dianne Hackborn247fe742011-01-08 17:25:57 -08003339 * the device is running low on storage. The default is 10.
3340 * <p>Say this value is set to 10, the device is considered running low on storage
Doug Zongker43866e02010-01-07 12:09:54 -08003341 * if 90% or more of the device storage is filled up.
3342 * @hide
3343 */
3344 public static final String SYS_STORAGE_THRESHOLD_PERCENTAGE =
3345 "sys_storage_threshold_percentage";
3346
3347 /**
Dianne Hackborn247fe742011-01-08 17:25:57 -08003348 * Maximum byte size of the low storage threshold. This is to ensure
3349 * that {@link #SYS_STORAGE_THRESHOLD_PERCENTAGE} does not result in
3350 * an overly large threshold for large storage devices. Currently this
3351 * must be less than 2GB. This default is 500MB.
3352 * @hide
3353 */
3354 public static final String SYS_STORAGE_THRESHOLD_MAX_BYTES =
3355 "sys_storage_threshold_max_bytes";
3356
3357 /**
Jake Hambybb371632010-08-23 18:16:48 -07003358 * Minimum bytes of free storage on the device before the data
3359 * partition is considered full. By default, 1 MB is reserved
3360 * to avoid system-wide SQLite disk full exceptions.
3361 * @hide
3362 */
3363 public static final String SYS_STORAGE_FULL_THRESHOLD_BYTES =
3364 "sys_storage_full_threshold_bytes";
3365
3366 /**
Doug Zongker43866e02010-01-07 12:09:54 -08003367 * The interval in milliseconds after which Wi-Fi is considered idle.
3368 * When idle, it is possible for the device to be switched from Wi-Fi to
3369 * the mobile data network.
3370 * @hide
3371 */
3372 public static final String WIFI_IDLE_MS = "wifi_idle_ms";
3373
3374 /**
Irfan Sheriff2b7f6382011-03-25 14:29:19 -07003375 * The interval in milliseconds to issue wake up scans when wifi needs
3376 * to connect. This is necessary to connect to an access point when
3377 * device is on the move and the screen is off.
Irfan Sheriff4f5f7c92010-10-14 17:01:27 -07003378 * @hide
3379 */
Irfan Sheriff2b7f6382011-03-25 14:29:19 -07003380 public static final String WIFI_FRAMEWORK_SCAN_INTERVAL_MS =
3381 "wifi_framework_scan_interval_ms";
3382
3383 /**
3384 * The interval in milliseconds to scan as used by the wifi supplicant
3385 * @hide
3386 */
3387 public static final String WIFI_SUPPLICANT_SCAN_INTERVAL_MS =
3388 "wifi_supplicant_scan_interval_ms";
Irfan Sheriff4f5f7c92010-10-14 17:01:27 -07003389
3390 /**
Doug Zongkeredc51892010-01-07 13:51:16 -08003391 * The interval in milliseconds at which to check packet counts on the
3392 * mobile data interface when screen is on, to detect possible data
3393 * connection problems.
3394 * @hide
3395 */
3396 public static final String PDP_WATCHDOG_POLL_INTERVAL_MS =
3397 "pdp_watchdog_poll_interval_ms";
3398
3399 /**
3400 * The interval in milliseconds at which to check packet counts on the
3401 * mobile data interface when screen is off, to detect possible data
3402 * connection problems.
3403 * @hide
3404 */
3405 public static final String PDP_WATCHDOG_LONG_POLL_INTERVAL_MS =
3406 "pdp_watchdog_long_poll_interval_ms";
3407
3408 /**
3409 * The interval in milliseconds at which to check packet counts on the
3410 * mobile data interface after {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT}
3411 * outgoing packets has been reached without incoming packets.
3412 * @hide
3413 */
3414 public static final String PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS =
3415 "pdp_watchdog_error_poll_interval_ms";
3416
3417 /**
3418 * The number of outgoing packets sent without seeing an incoming packet
3419 * that triggers a countdown (of {@link #PDP_WATCHDOG_ERROR_POLL_COUNT}
3420 * device is logged to the event log
3421 * @hide
3422 */
3423 public static final String PDP_WATCHDOG_TRIGGER_PACKET_COUNT =
3424 "pdp_watchdog_trigger_packet_count";
3425
3426 /**
3427 * The number of polls to perform (at {@link #PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS})
3428 * after hitting {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT} before
3429 * attempting data connection recovery.
3430 * @hide
3431 */
3432 public static final String PDP_WATCHDOG_ERROR_POLL_COUNT =
3433 "pdp_watchdog_error_poll_count";
3434
3435 /**
3436 * The number of failed PDP reset attempts before moving to something more
3437 * drastic: re-registering to the network.
3438 * @hide
3439 */
3440 public static final String PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT =
3441 "pdp_watchdog_max_pdp_reset_fail_count";
3442
3443 /**
Doug Zongkeredc51892010-01-07 13:51:16 -08003444 * The interval in milliseconds at which to check gprs registration
3445 * after the first registration mismatch of gprs and voice service,
3446 * to detect possible data network registration problems.
3447 *
3448 * @hide
3449 */
3450 public static final String GPRS_REGISTER_CHECK_PERIOD_MS =
3451 "gprs_register_check_period_ms";
3452
3453 /**
3454 * The length of time in milli-seconds that automatic small adjustments to
3455 * SystemClock are ignored if NITZ_UPDATE_DIFF is not exceeded.
3456 * @hide
3457 */
3458 public static final String NITZ_UPDATE_SPACING = "nitz_update_spacing";
3459
3460 /**
3461 * If the NITZ_UPDATE_DIFF time is exceeded then an automatic adjustment
3462 * to SystemClock will be allowed even if NITZ_UPDATE_SPACING has not been
3463 * exceeded.
3464 * @hide
3465 */
3466 public static final String NITZ_UPDATE_DIFF = "nitz_update_diff";
3467
3468 /**
3469 * The maximum reconnect delay for short network outages or when the network is suspended
3470 * due to phone use.
3471 * @hide
3472 */
3473 public static final String SYNC_MAX_RETRY_DELAY_IN_SECONDS =
3474 "sync_max_retry_delay_in_seconds";
3475
3476 /**
3477 * The interval in milliseconds at which to check the number of SMS sent
3478 * out without asking for use permit, to limit the un-authorized SMS
3479 * usage.
3480 * @hide
3481 */
3482 public static final String SMS_OUTGOING_CHECK_INTERVAL_MS =
3483 "sms_outgoing_check_interval_ms";
3484
3485 /**
3486 * The number of outgoing SMS sent without asking for user permit
3487 * (of {@link #SMS_OUTGOING_CHECK_INTERVAL_MS}
3488 * @hide
3489 */
3490 public static final String SMS_OUTGOING_CHECK_MAX_COUNT =
3491 "sms_outgoing_check_max_count";
3492
3493 /**
Narayan Kamathee69ff42011-06-28 12:07:18 +01003494 * The global search provider chosen by the user (if multiple global
3495 * search providers are installed). This will be the provider returned
3496 * by {@link SearchManager#getGlobalSearchActivity()} if it's still
3497 * installed. This setting is stored as a flattened component name as
3498 * per {@link ComponentName#flattenToString()}.
3499 *
3500 * @hide
3501 */
3502 public static final String SEARCH_GLOBAL_SEARCH_ACTIVITY =
3503 "search_global_search_activity";
3504
3505 /**
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003506 * The number of promoted sources in GlobalSearch.
3507 * @hide
3508 */
3509 public static final String SEARCH_NUM_PROMOTED_SOURCES = "search_num_promoted_sources";
3510 /**
3511 * The maximum number of suggestions returned by GlobalSearch.
3512 * @hide
3513 */
3514 public static final String SEARCH_MAX_RESULTS_TO_DISPLAY = "search_max_results_to_display";
3515 /**
3516 * The number of suggestions GlobalSearch will ask each non-web search source for.
3517 * @hide
3518 */
3519 public static final String SEARCH_MAX_RESULTS_PER_SOURCE = "search_max_results_per_source";
3520 /**
3521 * The number of suggestions the GlobalSearch will ask the web search source for.
3522 * @hide
3523 */
3524 public static final String SEARCH_WEB_RESULTS_OVERRIDE_LIMIT =
3525 "search_web_results_override_limit";
3526 /**
3527 * The number of milliseconds that GlobalSearch will wait for suggestions from
3528 * promoted sources before continuing with all other sources.
3529 * @hide
3530 */
3531 public static final String SEARCH_PROMOTED_SOURCE_DEADLINE_MILLIS =
3532 "search_promoted_source_deadline_millis";
3533 /**
3534 * The number of milliseconds before GlobalSearch aborts search suggesiton queries.
3535 * @hide
3536 */
3537 public static final String SEARCH_SOURCE_TIMEOUT_MILLIS = "search_source_timeout_millis";
3538 /**
3539 * The maximum number of milliseconds that GlobalSearch shows the previous results
3540 * after receiving a new query.
3541 * @hide
3542 */
3543 public static final String SEARCH_PREFILL_MILLIS = "search_prefill_millis";
3544 /**
3545 * The maximum age of log data used for shortcuts in GlobalSearch.
3546 * @hide
3547 */
3548 public static final String SEARCH_MAX_STAT_AGE_MILLIS = "search_max_stat_age_millis";
3549 /**
3550 * The maximum age of log data used for source ranking in GlobalSearch.
3551 * @hide
3552 */
3553 public static final String SEARCH_MAX_SOURCE_EVENT_AGE_MILLIS =
3554 "search_max_source_event_age_millis";
3555 /**
3556 * The minimum number of impressions needed to rank a source in GlobalSearch.
3557 * @hide
3558 */
3559 public static final String SEARCH_MIN_IMPRESSIONS_FOR_SOURCE_RANKING =
3560 "search_min_impressions_for_source_ranking";
3561 /**
3562 * The minimum number of clicks needed to rank a source in GlobalSearch.
3563 * @hide
3564 */
3565 public static final String SEARCH_MIN_CLICKS_FOR_SOURCE_RANKING =
3566 "search_min_clicks_for_source_ranking";
3567 /**
3568 * The maximum number of shortcuts shown by GlobalSearch.
3569 * @hide
3570 */
3571 public static final String SEARCH_MAX_SHORTCUTS_RETURNED = "search_max_shortcuts_returned";
3572 /**
3573 * The size of the core thread pool for suggestion queries in GlobalSearch.
3574 * @hide
3575 */
3576 public static final String SEARCH_QUERY_THREAD_CORE_POOL_SIZE =
3577 "search_query_thread_core_pool_size";
3578 /**
3579 * The maximum size of the thread pool for suggestion queries in GlobalSearch.
3580 * @hide
3581 */
3582 public static final String SEARCH_QUERY_THREAD_MAX_POOL_SIZE =
3583 "search_query_thread_max_pool_size";
3584 /**
3585 * The size of the core thread pool for shortcut refreshing in GlobalSearch.
3586 * @hide
3587 */
3588 public static final String SEARCH_SHORTCUT_REFRESH_CORE_POOL_SIZE =
3589 "search_shortcut_refresh_core_pool_size";
3590 /**
3591 * The maximum size of the thread pool for shortcut refreshing in GlobalSearch.
3592 * @hide
3593 */
3594 public static final String SEARCH_SHORTCUT_REFRESH_MAX_POOL_SIZE =
3595 "search_shortcut_refresh_max_pool_size";
3596 /**
3597 * The maximun time that excess threads in the GlobalSeach thread pools will
3598 * wait before terminating.
3599 * @hide
3600 */
3601 public static final String SEARCH_THREAD_KEEPALIVE_SECONDS =
3602 "search_thread_keepalive_seconds";
3603 /**
3604 * The maximum number of concurrent suggestion queries to each source.
3605 * @hide
3606 */
3607 public static final String SEARCH_PER_SOURCE_CONCURRENT_QUERY_LIMIT =
3608 "search_per_source_concurrent_query_limit";
3609
San Mehat87734d32010-01-08 12:53:06 -08003610 /**
3611 * Whether or not alert sounds are played on MountService events. (0 = false, 1 = true)
3612 * @hide
3613 */
3614 public static final String MOUNT_PLAY_NOTIFICATION_SND = "mount_play_not_snd";
3615
3616 /**
3617 * Whether or not UMS auto-starts on UMS host detection. (0 = false, 1 = true)
3618 * @hide
3619 */
3620 public static final String MOUNT_UMS_AUTOSTART = "mount_ums_autostart";
3621
3622 /**
3623 * Whether or not a notification is displayed on UMS host detection. (0 = false, 1 = true)
3624 * @hide
3625 */
3626 public static final String MOUNT_UMS_PROMPT = "mount_ums_prompt";
3627
3628 /**
3629 * Whether or not a notification is displayed while UMS is enabled. (0 = false, 1 = true)
3630 * @hide
3631 */
3632 public static final String MOUNT_UMS_NOTIFY_ENABLED = "mount_ums_notify_enabled";
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003633
Dan Egnor42471dd2010-01-07 17:25:22 -08003634 /**
3635 * If nonzero, ANRs in invisible background processes bring up a dialog.
3636 * Otherwise, the process will be silently killed.
3637 * @hide
3638 */
3639 public static final String ANR_SHOW_BACKGROUND = "anr_show_background";
Erikeebc8e22010-02-18 13:27:19 -08003640
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08003641 /**
3642 * The {@link ComponentName} string of the service to be used as the voice recognition
3643 * service.
Erikeebc8e22010-02-18 13:27:19 -08003644 *
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08003645 * @hide
3646 */
3647 public static final String VOICE_RECOGNITION_SERVICE = "voice_recognition_service";
Dan Egnor42471dd2010-01-07 17:25:22 -08003648
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003649 /**
David Brown458e8062010-03-08 21:52:11 -08003650 * What happens when the user presses the Power button while in-call
3651 * and the screen is on.<br/>
3652 * <b>Values:</b><br/>
3653 * 1 - The Power button turns off the screen and locks the device. (Default behavior)<br/>
3654 * 2 - The Power button hangs up the current call.<br/>
3655 *
3656 * @hide
3657 */
3658 public static final String INCALL_POWER_BUTTON_BEHAVIOR = "incall_power_button_behavior";
3659
3660 /**
3661 * INCALL_POWER_BUTTON_BEHAVIOR value for "turn off screen".
3662 * @hide
3663 */
3664 public static final int INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF = 0x1;
3665
3666 /**
3667 * INCALL_POWER_BUTTON_BEHAVIOR value for "hang up".
3668 * @hide
3669 */
3670 public static final int INCALL_POWER_BUTTON_BEHAVIOR_HANGUP = 0x2;
3671
3672 /**
3673 * INCALL_POWER_BUTTON_BEHAVIOR default value.
3674 * @hide
3675 */
3676 public static final int INCALL_POWER_BUTTON_BEHAVIOR_DEFAULT =
3677 INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF;
3678
3679 /**
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07003680 * The current night mode that has been selected by the user. Owned
3681 * and controlled by UiModeManagerService. Constants are as per
3682 * UiModeManager.
3683 * @hide
3684 */
3685 public static final String UI_NIGHT_MODE = "ui_night_mode";
Suchi Amalapurapu40e47252010-04-07 16:15:50 -07003686
3687 /**
3688 * Let user pick default install location.
3689 * @hide
3690 */
3691 public static final String SET_INSTALL_LOCATION = "set_install_location";
3692
3693 /**
3694 * Default install location value.
3695 * 0 = auto, let system decide
3696 * 1 = internal
3697 * 2 = sdcard
3698 * @hide
3699 */
3700 public static final String DEFAULT_INSTALL_LOCATION = "default_install_location";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003701
3702 /**
3703 * The bandwidth throttle polling freqency in seconds
3704 * @hide
3705 */
3706 public static final String THROTTLE_POLLING_SEC = "throttle_polling_sec";
3707
3708 /**
3709 * The bandwidth throttle threshold (long)
3710 * @hide
3711 */
Robert Greenwaltd3bb93f2010-04-12 19:20:55 -07003712 public static final String THROTTLE_THRESHOLD_BYTES = "throttle_threshold_bytes";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003713
3714 /**
3715 * The bandwidth throttle value (kbps)
3716 * @hide
3717 */
Robert Greenwaltd3bb93f2010-04-12 19:20:55 -07003718 public static final String THROTTLE_VALUE_KBITSPS = "throttle_value_kbitsps";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003719
3720 /**
3721 * The bandwidth throttle reset calendar day (1-28)
3722 * @hide
3723 */
3724 public static final String THROTTLE_RESET_DAY = "throttle_reset_day";
3725
3726 /**
3727 * The throttling notifications we should send
3728 * @hide
3729 */
3730 public static final String THROTTLE_NOTIFICATION_TYPE = "throttle_notification_type";
3731
3732 /**
Irfan Sheriffc9b68512010-04-08 14:12:33 -07003733 * Help URI for data throttling policy
3734 * @hide
3735 */
3736 public static final String THROTTLE_HELP_URI = "throttle_help_uri";
3737
Robert Greenwaltd1055a22010-05-25 15:54:52 -07003738 /**
3739 * The length of time in Sec that we allow our notion of NTP time
3740 * to be cached before we refresh it
3741 * @hide
3742 */
3743 public static final String THROTTLE_MAX_NTP_CACHE_AGE_SEC =
3744 "throttle_max_ntp_cache_age_sec";
3745
Steve Howard9c4e33e2010-07-28 15:59:29 -07003746 /**
3747 * The maximum size, in bytes, of a download that the download manager will transfer over
3748 * a non-wifi connection.
3749 * @hide
3750 */
3751 public static final String DOWNLOAD_MAX_BYTES_OVER_MOBILE =
3752 "download_manager_max_bytes_over_mobile";
3753
Robert Greenwaltd7085fc2010-09-08 15:24:47 -07003754 /**
Steve Howardf1766812010-09-17 16:46:19 -07003755 * The recommended maximum size, in bytes, of a download that the download manager should
3756 * transfer over a non-wifi connection. Over this size, the use will be warned, but will
3757 * have the option to start the download over the mobile connection anyway.
3758 * @hide
3759 */
3760 public static final String DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE =
3761 "download_manager_recommended_max_bytes_over_mobile";
3762
3763 /**
Robert Greenwaltd7085fc2010-09-08 15:24:47 -07003764 * ms during which to consume extra events related to Inet connection condition
3765 * after a transtion to fully-connected
3766 * @hide
3767 */
3768 public static final String INET_CONDITION_DEBOUNCE_UP_DELAY =
3769 "inet_condition_debounce_up_delay";
3770
3771 /**
3772 * ms during which to consume extra events related to Inet connection condtion
3773 * after a transtion to partly-connected
3774 * @hide
3775 */
3776 public static final String INET_CONDITION_DEBOUNCE_DOWN_DELAY =
3777 "inet_condition_debounce_down_delay";
Irfan Sheriffc9b68512010-04-08 14:12:33 -07003778
3779 /**
Freeman Ng96be4e02011-04-07 18:21:40 -07003780 * URL to open browser on to allow user to manage a prepay account
3781 * @hide
3782 */
3783 public static final String SETUP_PREPAID_DATA_SERVICE_URL =
3784 "setup_prepaid_data_service_url";
3785
3786 /**
Freeman Ng3b9089c2011-04-22 16:42:57 -07003787 * URL to attempt a GET on to see if this is a prepay device
3788 * @hide
3789 */
3790 public static final String SETUP_PREPAID_DETECTION_TARGET_URL =
3791 "setup_prepaid_detection_target_url";
3792
3793 /**
3794 * Host to check for a redirect to after an attempt to GET
3795 * SETUP_PREPAID_DETECTION_TARGET_URL. (If we redirected there,
3796 * this is a prepaid device with zero balance.)
3797 * @hide
3798 */
3799 public static final String SETUP_PREPAID_DETECTION_REDIR_HOST =
3800 "setup_prepaid_detection_redir_host";
3801
3802 /**
Daniel Sandler0601eb72011-04-13 01:01:32 -04003803 * The user's preferred "dream" (interactive screensaver) component.
3804 *
3805 * This component will be launched by the PhoneWindowManager after the user's chosen idle
3806 * timeout (specified by {@link #DREAM_TIMEOUT}).
3807 * @hide
3808 */
3809 public static final String DREAM_COMPONENT =
3810 "dream_component";
3811
3812 /**
3813 * The delay before a "dream" is started (set to 0 to disable).
3814 * @hide
3815 */
3816 public static final String DREAM_TIMEOUT =
3817 "dream_timeout";
3818
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003819 /** {@hide} */
Jeff Sharkey0a9ee122011-06-22 16:32:41 -07003820 public static final String NETSTATS_ENABLED = "netstats_enabled";
3821 /** {@hide} */
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003822 public static final String NETSTATS_POLL_INTERVAL = "netstats_poll_interval";
3823 /** {@hide} */
3824 public static final String NETSTATS_PERSIST_THRESHOLD = "netstats_persist_threshold";
3825 /** {@hide} */
Jeff Sharkey39ebc212011-06-11 17:25:42 -07003826 public static final String NETSTATS_NETWORK_BUCKET_DURATION = "netstats_network_bucket_duration";
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003827 /** {@hide} */
Jeff Sharkey39ebc212011-06-11 17:25:42 -07003828 public static final String NETSTATS_NETWORK_MAX_HISTORY = "netstats_network_max_history";
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003829 /** {@hide} */
Jeff Sharkey39ebc212011-06-11 17:25:42 -07003830 public static final String NETSTATS_UID_BUCKET_DURATION = "netstats_uid_bucket_duration";
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003831 /** {@hide} */
Jeff Sharkey39ebc212011-06-11 17:25:42 -07003832 public static final String NETSTATS_UID_MAX_HISTORY = "netstats_uid_max_history";
Jeff Sharkeyd03fd3f2011-06-19 20:55:09 -07003833 /** {@hide} */
3834 public static final String NETSTATS_TAG_MAX_HISTORY = "netstats_tag_max_history";
Jeff Sharkey61ee0bb2011-05-29 22:50:42 -07003835
Daniel Sandler0601eb72011-04-13 01:01:32 -04003836 /**
-b master501eec92009-07-06 13:53:11 -07003837 * @hide
3838 */
3839 public static final String[] SETTINGS_TO_BACKUP = {
Amith Yamasani8823c0a82009-07-07 14:30:17 -07003840 ADB_ENABLED,
3841 ALLOW_MOCK_LOCATION,
-b master501eec92009-07-06 13:53:11 -07003842 PARENTAL_CONTROL_ENABLED,
3843 PARENTAL_CONTROL_REDIRECT_URL,
3844 USB_MASS_STORAGE_ENABLED,
3845 ACCESSIBILITY_ENABLED,
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07003846 ACCESSIBILITY_SCRIPT_INJECTION,
Christopher Tate14c2d792010-02-25 16:49:44 -08003847 BACKUP_AUTO_RESTORE,
-b master501eec92009-07-06 13:53:11 -07003848 ENABLED_ACCESSIBILITY_SERVICES,
3849 TTS_USE_DEFAULTS,
3850 TTS_DEFAULT_RATE,
3851 TTS_DEFAULT_PITCH,
3852 TTS_DEFAULT_SYNTH,
3853 TTS_DEFAULT_LANG,
3854 TTS_DEFAULT_COUNTRY,
Charles Chenceffa152010-03-16 21:18:10 -07003855 TTS_ENABLED_PLUGINS,
-b master501eec92009-07-06 13:53:11 -07003856 WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,
3857 WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,
-b master501eec92009-07-06 13:53:11 -07003858 WIFI_NUM_OPEN_NETWORKS_KEPT,
San Mehat87734d32010-01-08 12:53:06 -08003859 MOUNT_PLAY_NOTIFICATION_SND,
3860 MOUNT_UMS_AUTOSTART,
3861 MOUNT_UMS_PROMPT,
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07003862 MOUNT_UMS_NOTIFY_ENABLED,
3863 UI_NIGHT_MODE
-b master501eec92009-07-06 13:53:11 -07003864 };
3865
3866 /**
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003867 * Helper method for determining if a location provider is enabled.
3868 * @param cr the content resolver to use
3869 * @param provider the location provider to query
3870 * @return true if the provider is enabled
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003871 */
3872 public static final boolean isLocationProviderEnabled(ContentResolver cr, String provider) {
3873 String allowedProviders = Settings.Secure.getString(cr, LOCATION_PROVIDERS_ALLOWED);
Brad Fitzpatrick11fe1812010-09-10 16:07:52 -07003874 return TextUtils.delimitedStringContains(allowedProviders, ',', provider);
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003875 }
3876
3877 /**
3878 * Thread-safe method for enabling or disabling a single location provider.
3879 * @param cr the content resolver to use
3880 * @param provider the location provider to enable or disable
3881 * @param enabled true if the provider should be enabled
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003882 */
3883 public static final void setLocationProviderEnabled(ContentResolver cr,
3884 String provider, boolean enabled) {
3885 // to ensure thread safety, we write the provider name with a '+' or '-'
3886 // and let the SettingsProvider handle it rather than reading and modifying
3887 // the list of enabled providers.
3888 if (enabled) {
3889 provider = "+" + provider;
3890 } else {
3891 provider = "-" + provider;
3892 }
3893 putString(cr, Settings.Secure.LOCATION_PROVIDERS_ALLOWED, provider);
3894 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003895 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003896
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003897 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003898 * User-defined bookmarks and shortcuts. The target of each bookmark is an
3899 * Intent URL, allowing it to be either a web page or a particular
3900 * application activity.
3901 *
3902 * @hide
3903 */
3904 public static final class Bookmarks implements BaseColumns
3905 {
3906 private static final String TAG = "Bookmarks";
3907
3908 /**
3909 * The content:// style URL for this table
3910 */
3911 public static final Uri CONTENT_URI =
3912 Uri.parse("content://" + AUTHORITY + "/bookmarks");
3913
3914 /**
3915 * The row ID.
3916 * <p>Type: INTEGER</p>
3917 */
3918 public static final String ID = "_id";
3919
3920 /**
3921 * Descriptive name of the bookmark that can be displayed to the user.
3922 * If this is empty, the title should be resolved at display time (use
3923 * {@link #getTitle(Context, Cursor)} any time you want to display the
3924 * title of a bookmark.)
3925 * <P>
3926 * Type: TEXT
3927 * </P>
3928 */
3929 public static final String TITLE = "title";
3930
3931 /**
3932 * Arbitrary string (displayed to the user) that allows bookmarks to be
3933 * organized into categories. There are some special names for
3934 * standard folders, which all start with '@'. The label displayed for
3935 * the folder changes with the locale (via {@link #getLabelForFolder}) but
3936 * the folder name does not change so you can consistently query for
3937 * the folder regardless of the current locale.
3938 *
3939 * <P>Type: TEXT</P>
3940 *
3941 */
3942 public static final String FOLDER = "folder";
3943
3944 /**
3945 * The Intent URL of the bookmark, describing what it points to. This
3946 * value is given to {@link android.content.Intent#getIntent} to create
3947 * an Intent that can be launched.
3948 * <P>Type: TEXT</P>
3949 */
3950 public static final String INTENT = "intent";
3951
3952 /**
3953 * Optional shortcut character associated with this bookmark.
3954 * <P>Type: INTEGER</P>
3955 */
3956 public static final String SHORTCUT = "shortcut";
3957
3958 /**
3959 * The order in which the bookmark should be displayed
3960 * <P>Type: INTEGER</P>
3961 */
3962 public static final String ORDERING = "ordering";
3963
3964 private static final String[] sIntentProjection = { INTENT };
3965 private static final String[] sShortcutProjection = { ID, SHORTCUT };
3966 private static final String sShortcutSelection = SHORTCUT + "=?";
3967
3968 /**
3969 * Convenience function to retrieve the bookmarked Intent for a
3970 * particular shortcut key.
3971 *
3972 * @param cr The ContentResolver to query.
3973 * @param shortcut The shortcut key.
3974 *
3975 * @return Intent The bookmarked URL, or null if there is no bookmark
3976 * matching the given shortcut.
3977 */
3978 public static Intent getIntentForShortcut(ContentResolver cr, char shortcut)
3979 {
3980 Intent intent = null;
3981
3982 Cursor c = cr.query(CONTENT_URI,
3983 sIntentProjection, sShortcutSelection,
3984 new String[] { String.valueOf((int) shortcut) }, ORDERING);
3985 // Keep trying until we find a valid shortcut
3986 try {
3987 while (intent == null && c.moveToNext()) {
3988 try {
3989 String intentURI = c.getString(c.getColumnIndexOrThrow(INTENT));
Christian Mehlmauera34d2c92010-05-25 19:04:20 +02003990 intent = Intent.parseUri(intentURI, 0);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003991 } catch (java.net.URISyntaxException e) {
3992 // The stored URL is bad... ignore it.
3993 } catch (IllegalArgumentException e) {
3994 // Column not found
Dianne Hackborna33e3f72009-09-29 17:28:24 -07003995 Log.w(TAG, "Intent column not found", e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003996 }
3997 }
3998 } finally {
3999 if (c != null) c.close();
4000 }
4001
4002 return intent;
4003 }
4004
4005 /**
4006 * Add a new bookmark to the system.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004007 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004008 * @param cr The ContentResolver to query.
4009 * @param intent The desired target of the bookmark.
4010 * @param title Bookmark title that is shown to the user; null if none
4011 * or it should be resolved to the intent's title.
4012 * @param folder Folder in which to place the bookmark; null if none.
4013 * @param shortcut Shortcut that will invoke the bookmark; 0 if none. If
4014 * this is non-zero and there is an existing bookmark entry
4015 * with this same shortcut, then that existing shortcut is
4016 * cleared (the bookmark is not removed).
4017 * @return The unique content URL for the new bookmark entry.
4018 */
4019 public static Uri add(ContentResolver cr,
4020 Intent intent,
4021 String title,
4022 String folder,
4023 char shortcut,
4024 int ordering)
4025 {
4026 // If a shortcut is supplied, and it is already defined for
4027 // another bookmark, then remove the old definition.
4028 if (shortcut != 0) {
Jeff Hamilton7cd51ef2010-05-12 17:30:27 -05004029 cr.delete(CONTENT_URI, sShortcutSelection,
4030 new String[] { String.valueOf((int) shortcut) });
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004031 }
4032
4033 ContentValues values = new ContentValues();
4034 if (title != null) values.put(TITLE, title);
4035 if (folder != null) values.put(FOLDER, folder);
Jean-Baptiste Queru3b9f0a32010-06-21 13:46:59 -07004036 values.put(INTENT, intent.toUri(0));
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004037 if (shortcut != 0) values.put(SHORTCUT, (int) shortcut);
4038 values.put(ORDERING, ordering);
4039 return cr.insert(CONTENT_URI, values);
4040 }
4041
4042 /**
4043 * Return the folder name as it should be displayed to the user. This
4044 * takes care of localizing special folders.
4045 *
4046 * @param r Resources object for current locale; only need access to
4047 * system resources.
4048 * @param folder The value found in the {@link #FOLDER} column.
4049 *
4050 * @return CharSequence The label for this folder that should be shown
4051 * to the user.
4052 */
4053 public static CharSequence getLabelForFolder(Resources r, String folder) {
4054 return folder;
4055 }
4056
4057 /**
4058 * Return the title as it should be displayed to the user. This takes
4059 * care of localizing bookmarks that point to activities.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004060 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004061 * @param context A context.
4062 * @param cursor A cursor pointing to the row whose title should be
4063 * returned. The cursor must contain at least the {@link #TITLE}
4064 * and {@link #INTENT} columns.
4065 * @return A title that is localized and can be displayed to the user,
4066 * or the empty string if one could not be found.
4067 */
4068 public static CharSequence getTitle(Context context, Cursor cursor) {
4069 int titleColumn = cursor.getColumnIndex(TITLE);
4070 int intentColumn = cursor.getColumnIndex(INTENT);
4071 if (titleColumn == -1 || intentColumn == -1) {
4072 throw new IllegalArgumentException(
4073 "The cursor must contain the TITLE and INTENT columns.");
4074 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004075
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004076 String title = cursor.getString(titleColumn);
4077 if (!TextUtils.isEmpty(title)) {
4078 return title;
4079 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004080
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004081 String intentUri = cursor.getString(intentColumn);
4082 if (TextUtils.isEmpty(intentUri)) {
4083 return "";
4084 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004085
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004086 Intent intent;
4087 try {
Christian Mehlmauera34d2c92010-05-25 19:04:20 +02004088 intent = Intent.parseUri(intentUri, 0);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004089 } catch (URISyntaxException e) {
4090 return "";
4091 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004092
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004093 PackageManager packageManager = context.getPackageManager();
4094 ResolveInfo info = packageManager.resolveActivity(intent, 0);
4095 return info != null ? info.loadLabel(packageManager) : "";
4096 }
4097 }
4098
4099 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004100 * Returns the device ID that we should use when connecting to the mobile gtalk server.
4101 * This is a string like "android-0x1242", where the hex string is the Android ID obtained
4102 * from the GoogleLoginService.
4103 *
4104 * @param androidId The Android ID for this device.
4105 * @return The device ID that should be used when connecting to the mobile gtalk server.
4106 * @hide
4107 */
4108 public static String getGTalkDeviceId(long androidId) {
4109 return "android-" + Long.toHexString(androidId);
4110 }
4111}