blob: 7bb89f5cb14c0b180b14b799e7150da6a8798d2c [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
19import com.google.android.collect.Maps;
20
21import org.apache.commons.codec.binary.Base64;
22
23import android.annotation.SdkConstant;
24import android.annotation.SdkConstant.SdkConstantType;
Mike LeBeau5d34e9b2010-02-10 19:34:56 -080025import android.content.ComponentName;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080026import android.content.ContentQueryMap;
27import android.content.ContentResolver;
28import android.content.ContentValues;
29import android.content.Context;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -080030import android.content.IContentProvider;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080031import android.content.Intent;
Dianne Hackbornb8b11a02010-03-10 15:53:11 -080032import android.content.pm.ActivityInfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080033import android.content.pm.PackageManager;
34import android.content.pm.ResolveInfo;
35import android.content.res.Configuration;
36import android.content.res.Resources;
37import android.database.Cursor;
38import android.database.SQLException;
39import android.net.Uri;
40import android.os.*;
41import android.telephony.TelephonyManager;
42import android.text.TextUtils;
43import android.util.AndroidException;
Dan Egnor799f7212009-11-24 16:24:44 -080044import android.util.Config;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080045import android.util.Log;
46
47import java.net.URISyntaxException;
48import java.security.MessageDigest;
49import java.security.NoSuchAlgorithmException;
Vasu Nori272af002009-11-04 16:26:55 -080050import java.util.Collections;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080051import java.util.HashMap;
52import java.util.HashSet;
Vasu Nori272af002009-11-04 16:26:55 -080053import java.util.Map;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080054
55
56/**
57 * The Settings provider contains global system-level device preferences.
58 */
59public final class Settings {
60
61 // Intent actions for Settings
62
63 /**
64 * Activity Action: Show system settings.
65 * <p>
66 * Input: Nothing.
67 * <p>
68 * Output: nothing.
69 */
70 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
71 public static final String ACTION_SETTINGS = "android.settings.SETTINGS";
72
73 /**
74 * Activity Action: Show settings to allow configuration of APNs.
75 * <p>
76 * Input: Nothing.
77 * <p>
78 * Output: nothing.
79 */
80 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
81 public static final String ACTION_APN_SETTINGS = "android.settings.APN_SETTINGS";
82
83 /**
84 * Activity Action: Show settings to allow configuration of current location
85 * sources.
86 * <p>
87 * In some cases, a matching Activity may not exist, so ensure you
88 * safeguard against this.
89 * <p>
90 * Input: Nothing.
91 * <p>
92 * Output: Nothing.
93 */
94 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
95 public static final String ACTION_LOCATION_SOURCE_SETTINGS =
96 "android.settings.LOCATION_SOURCE_SETTINGS";
97
98 /**
99 * Activity Action: Show settings to allow configuration of wireless controls
100 * such as Wi-Fi, Bluetooth and Mobile networks.
101 * <p>
102 * In some cases, a matching Activity may not exist, so ensure you
103 * safeguard against this.
104 * <p>
105 * Input: Nothing.
106 * <p>
107 * Output: Nothing.
108 */
109 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
110 public static final String ACTION_WIRELESS_SETTINGS =
111 "android.settings.WIRELESS_SETTINGS";
112
113 /**
114 * Activity Action: Show settings to allow entering/exiting airplane mode.
115 * <p>
116 * In some cases, a matching Activity may not exist, so ensure you
117 * safeguard against this.
118 * <p>
119 * Input: Nothing.
120 * <p>
121 * Output: Nothing.
122 */
123 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
124 public static final String ACTION_AIRPLANE_MODE_SETTINGS =
125 "android.settings.AIRPLANE_MODE_SETTINGS";
126
127 /**
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700128 * Activity Action: Show settings for accessibility modules.
129 * <p>
130 * In some cases, a matching Activity may not exist, so ensure you
131 * safeguard against this.
132 * <p>
133 * Input: Nothing.
134 * <p>
135 * Output: Nothing.
136 */
137 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
138 public static final String ACTION_ACCESSIBILITY_SETTINGS =
139 "android.settings.ACCESSIBILITY_SETTINGS";
140
141 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800142 * Activity Action: Show settings to allow configuration of security and
143 * location privacy.
144 * <p>
145 * In some cases, a matching Activity may not exist, so ensure you
146 * safeguard against this.
147 * <p>
148 * Input: Nothing.
149 * <p>
150 * Output: Nothing.
151 */
152 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
153 public static final String ACTION_SECURITY_SETTINGS =
154 "android.settings.SECURITY_SETTINGS";
155
156 /**
Amith Yamasanic15255a2009-09-23 15:33:19 -0700157 * Activity Action: Show settings to allow configuration of privacy options.
158 * <p>
159 * In some cases, a matching Activity may not exist, so ensure you
160 * safeguard against this.
161 * <p>
162 * Input: Nothing.
163 * <p>
164 * Output: Nothing.
165 */
166 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
167 public static final String ACTION_PRIVACY_SETTINGS =
168 "android.settings.PRIVACY_SETTINGS";
169
170 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800171 * Activity Action: Show settings to allow configuration of Wi-Fi.
172
173 * <p>
174 * In some cases, a matching Activity may not exist, so ensure you
175 * safeguard against this.
176 * <p>
177 * Input: Nothing.
178 * <p>
179 * Output: Nothing.
180
181 */
182 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
183 public static final String ACTION_WIFI_SETTINGS =
184 "android.settings.WIFI_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700185
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800186 /**
187 * Activity Action: Show settings to allow configuration of a static IP
188 * address for Wi-Fi.
189 * <p>
190 * In some cases, a matching Activity may not exist, so ensure you safeguard
191 * against this.
192 * <p>
193 * Input: Nothing.
194 * <p>
195 * Output: Nothing.
196 */
197 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
198 public static final String ACTION_WIFI_IP_SETTINGS =
199 "android.settings.WIFI_IP_SETTINGS";
200
201 /**
202 * Activity Action: Show settings to allow configuration of Bluetooth.
203 * <p>
204 * In some cases, a matching Activity may not exist, so ensure you
205 * safeguard against this.
206 * <p>
207 * Input: Nothing.
208 * <p>
209 * Output: Nothing.
210 */
211 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
212 public static final String ACTION_BLUETOOTH_SETTINGS =
213 "android.settings.BLUETOOTH_SETTINGS";
214
215 /**
216 * Activity Action: Show settings to allow configuration of date and time.
217 * <p>
218 * In some cases, a matching Activity may not exist, so ensure you
219 * safeguard against this.
220 * <p>
221 * Input: Nothing.
222 * <p>
223 * Output: Nothing.
224 */
225 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
226 public static final String ACTION_DATE_SETTINGS =
227 "android.settings.DATE_SETTINGS";
228
229 /**
230 * Activity Action: Show settings to allow configuration of sound and volume.
231 * <p>
232 * In some cases, a matching Activity may not exist, so ensure you
233 * safeguard against this.
234 * <p>
235 * Input: Nothing.
236 * <p>
237 * Output: Nothing.
238 */
239 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
240 public static final String ACTION_SOUND_SETTINGS =
241 "android.settings.SOUND_SETTINGS";
242
243 /**
244 * Activity Action: Show settings to allow configuration of display.
245 * <p>
246 * In some cases, a matching Activity may not exist, so ensure you
247 * safeguard against this.
248 * <p>
249 * Input: Nothing.
250 * <p>
251 * Output: Nothing.
252 */
253 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
254 public static final String ACTION_DISPLAY_SETTINGS =
255 "android.settings.DISPLAY_SETTINGS";
256
257 /**
258 * Activity Action: Show settings to allow configuration of locale.
259 * <p>
260 * In some cases, a matching Activity may not exist, so ensure you
261 * safeguard against this.
262 * <p>
263 * Input: Nothing.
264 * <p>
265 * Output: Nothing.
266 */
267 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
268 public static final String ACTION_LOCALE_SETTINGS =
269 "android.settings.LOCALE_SETTINGS";
270
271 /**
272 * Activity Action: Show settings to configure input methods, in particular
273 * allowing the user to enable input methods.
274 * <p>
275 * In some cases, a matching Activity may not exist, so ensure you
276 * safeguard against this.
277 * <p>
278 * Input: Nothing.
279 * <p>
280 * Output: Nothing.
281 */
282 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
283 public static final String ACTION_INPUT_METHOD_SETTINGS =
284 "android.settings.INPUT_METHOD_SETTINGS";
285
286 /**
287 * Activity Action: Show settings to manage the user input dictionary.
288 * <p>
289 * In some cases, a matching Activity may not exist, so ensure you
290 * safeguard against this.
291 * <p>
292 * Input: Nothing.
293 * <p>
294 * Output: Nothing.
295 */
296 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
297 public static final String ACTION_USER_DICTIONARY_SETTINGS =
298 "android.settings.USER_DICTIONARY_SETTINGS";
299
300 /**
301 * Activity Action: Show settings to allow configuration of application-related settings.
302 * <p>
303 * In some cases, a matching Activity may not exist, so ensure you
304 * safeguard against this.
305 * <p>
306 * Input: Nothing.
307 * <p>
308 * Output: Nothing.
309 */
310 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
311 public static final String ACTION_APPLICATION_SETTINGS =
312 "android.settings.APPLICATION_SETTINGS";
313
314 /**
315 * Activity Action: Show settings to allow configuration of application
316 * development-related settings.
317 * <p>
318 * In some cases, a matching Activity may not exist, so ensure you safeguard
319 * against this.
320 * <p>
321 * Input: Nothing.
322 * <p>
323 * Output: Nothing.
324 */
325 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
326 public static final String ACTION_APPLICATION_DEVELOPMENT_SETTINGS =
327 "android.settings.APPLICATION_DEVELOPMENT_SETTINGS";
328
329 /**
330 * Activity Action: Show settings to allow configuration of quick launch shortcuts.
331 * <p>
332 * In some cases, a matching Activity may not exist, so ensure you
333 * safeguard against this.
334 * <p>
335 * Input: Nothing.
336 * <p>
337 * Output: Nothing.
338 */
339 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
340 public static final String ACTION_QUICK_LAUNCH_SETTINGS =
341 "android.settings.QUICK_LAUNCH_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700342
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800343 /**
344 * Activity Action: Show settings to manage installed applications.
345 * <p>
346 * In some cases, a matching Activity may not exist, so ensure you
347 * safeguard against this.
348 * <p>
349 * Input: Nothing.
350 * <p>
351 * Output: Nothing.
352 */
353 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
354 public static final String ACTION_MANAGE_APPLICATIONS_SETTINGS =
355 "android.settings.MANAGE_APPLICATIONS_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700356
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800357 /**
Dianne Hackbornb7bb3b32010-06-06 22:47:50 -0700358 * Activity Action: Show screen of details about a particular application.
359 * <p>
360 * In some cases, a matching Activity may not exist, so ensure you
361 * safeguard against this.
362 * <p>
363 * Input: The Intent's data URI specifies the application package name
364 * to be shown, with the "package" scheme. That is "package:com.my.app".
365 * <p>
366 * Output: Nothing.
367 */
368 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
369 public static final String ACTION_APPLICATION_DETAILS_SETTINGS =
370 "android.settings.APPLICATION_DETAILS_SETTINGS";
371
372 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800373 * Activity Action: Show settings for system update functionality.
374 * <p>
375 * In some cases, a matching Activity may not exist, so ensure you
376 * safeguard against this.
377 * <p>
378 * Input: Nothing.
379 * <p>
380 * Output: Nothing.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700381 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800382 * @hide
383 */
384 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
385 public static final String ACTION_SYSTEM_UPDATE_SETTINGS =
386 "android.settings.SYSTEM_UPDATE_SETTINGS";
387
388 /**
389 * Activity Action: Show settings to allow configuration of sync settings.
390 * <p>
391 * In some cases, a matching Activity may not exist, so ensure you
392 * safeguard against this.
393 * <p>
Erikeebc8e22010-02-18 13:27:19 -0800394 * The account types available to add via the add account button may be restricted by adding an
395 * {@link #EXTRA_AUTHORITIES} extra to this Intent with one or more syncable content provider's
396 * authorities. Only account types which can sync with that content provider will be offered to
397 * the user.
398 * <p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800399 * Input: Nothing.
400 * <p>
401 * Output: Nothing.
402 */
403 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
404 public static final String ACTION_SYNC_SETTINGS =
405 "android.settings.SYNC_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700406
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800407 /**
Erikeebc8e22010-02-18 13:27:19 -0800408 * Activity Action: Show add account screen for creating a new account.
409 * <p>
410 * In some cases, a matching Activity may not exist, so ensure you
411 * safeguard against this.
412 * <p>
413 * The account types available to add may be restricted by adding an {@link #EXTRA_AUTHORITIES}
414 * extra to the Intent with one or more syncable content provider's authorities. Only account
415 * types which can sync with that content provider will be offered to the user.
416 * <p>
417 * Input: Nothing.
418 * <p>
419 * Output: Nothing.
420 */
421 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
422 public static final String ACTION_ADD_ACCOUNT =
423 "android.settings.ADD_ACCOUNT_SETTINGS";
424
425 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800426 * Activity Action: Show settings for selecting the network operator.
427 * <p>
428 * In some cases, a matching Activity may not exist, so ensure you
429 * safeguard against this.
430 * <p>
431 * Input: Nothing.
432 * <p>
433 * Output: Nothing.
434 */
435 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
436 public static final String ACTION_NETWORK_OPERATOR_SETTINGS =
437 "android.settings.NETWORK_OPERATOR_SETTINGS";
438
439 /**
440 * Activity Action: Show settings for selection of 2G/3G.
441 * <p>
442 * In some cases, a matching Activity may not exist, so ensure you
443 * safeguard against this.
444 * <p>
445 * Input: Nothing.
446 * <p>
447 * Output: Nothing.
448 */
449 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
450 public static final String ACTION_DATA_ROAMING_SETTINGS =
451 "android.settings.DATA_ROAMING_SETTINGS";
452
453 /**
454 * Activity Action: Show settings for internal storage.
455 * <p>
456 * In some cases, a matching Activity may not exist, so ensure you
457 * safeguard against this.
458 * <p>
459 * Input: Nothing.
460 * <p>
461 * Output: Nothing.
462 */
463 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
464 public static final String ACTION_INTERNAL_STORAGE_SETTINGS =
465 "android.settings.INTERNAL_STORAGE_SETTINGS";
466 /**
467 * Activity Action: Show settings for memory card storage.
468 * <p>
469 * In some cases, a matching Activity may not exist, so ensure you
470 * safeguard against this.
471 * <p>
472 * Input: Nothing.
473 * <p>
474 * Output: Nothing.
475 */
476 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
477 public static final String ACTION_MEMORY_CARD_SETTINGS =
478 "android.settings.MEMORY_CARD_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700479
Justin Mattsonef340352010-01-13 21:05:46 -0800480 /**
481 * Activity Action: Show settings for global search.
482 * <p>
483 * In some cases, a matching Activity may not exist, so ensure you
484 * safeguard against this.
485 * <p>
486 * Input: Nothing.
487 * <p>
488 * Output: Nothing
489 */
490 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
491 public static final String ACTION_SEARCH_SETTINGS =
492 "android.search.action.SEARCH_SETTINGS";
493
Daniel Sandler9d8b8762010-01-22 20:50:15 -0500494 /**
495 * Activity Action: Show general device information settings (serial
496 * number, software version, phone number, etc.).
497 * <p>
498 * In some cases, a matching Activity may not exist, so ensure you
499 * safeguard against this.
500 * <p>
501 * Input: Nothing.
502 * <p>
503 * Output: Nothing
504 */
505 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
506 public static final String ACTION_DEVICE_INFO_SETTINGS =
507 "android.settings.DEVICE_INFO_SETTINGS";
508
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800509 // End of Intent actions for Settings
510
Erikeebc8e22010-02-18 13:27:19 -0800511 /**
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800512 * @hide - Private call() method on SettingsProvider to read from 'system' table.
513 */
514 public static final String CALL_METHOD_GET_SYSTEM = "GET_system";
515
516 /**
517 * @hide - Private call() method on SettingsProvider to read from 'secure' table.
518 */
519 public static final String CALL_METHOD_GET_SECURE = "GET_secure";
520
521 /**
Erikeebc8e22010-02-18 13:27:19 -0800522 * Activity Extra: Limit available options in launched activity based on the given authority.
523 * <p>
524 * This can be passed as an extra field in an Activity Intent with one or more syncable content
525 * provider's authorities as a String[]. This field is used by some intents to alter the
526 * behavior of the called activity.
527 * <p>
528 * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types available based
529 * on the authority given.
530 */
531 public static final String EXTRA_AUTHORITIES =
532 "authorities";
533
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800534 private static final String JID_RESOURCE_PREFIX = "android";
535
536 public static final String AUTHORITY = "settings";
537
538 private static final String TAG = "Settings";
Dan Egnor799f7212009-11-24 16:24:44 -0800539 private static final boolean LOCAL_LOGV = Config.LOGV || false;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800540
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800541 public static class SettingNotFoundException extends AndroidException {
542 public SettingNotFoundException(String msg) {
543 super(msg);
544 }
545 }
546
547 /**
548 * Common base for tables of name/value settings.
549 */
550 public static class NameValueTable implements BaseColumns {
551 public static final String NAME = "name";
552 public static final String VALUE = "value";
553
554 protected static boolean putString(ContentResolver resolver, Uri uri,
555 String name, String value) {
556 // The database will take care of replacing duplicates.
557 try {
558 ContentValues values = new ContentValues();
559 values.put(NAME, name);
560 values.put(VALUE, value);
561 resolver.insert(uri, values);
562 return true;
563 } catch (SQLException e) {
Dianne Hackborna33e3f72009-09-29 17:28:24 -0700564 Log.w(TAG, "Can't set key " + name + " in " + uri, e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800565 return false;
566 }
567 }
568
569 public static Uri getUriFor(Uri uri, String name) {
570 return Uri.withAppendedPath(uri, name);
571 }
572 }
573
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800574 // Thread-safe.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800575 private static class NameValueCache {
576 private final String mVersionSystemProperty;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800577 private final Uri mUri;
578
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800579 private static final String[] SELECT_VALUE =
580 new String[] { Settings.NameValueTable.VALUE };
581 private static final String NAME_EQ_PLACEHOLDER = "name=?";
582
583 // Must synchronize on 'this' to access mValues and mValuesVersion.
Dan Egnor799f7212009-11-24 16:24:44 -0800584 private final HashMap<String, String> mValues = new HashMap<String, String>();
585 private long mValuesVersion = 0;
586
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800587 // Initially null; set lazily and held forever. Synchronized on 'this'.
588 private IContentProvider mContentProvider = null;
589
590 // The method we'll call (or null, to not use) on the provider
591 // for the fast path of retrieving settings.
592 private final String mCallCommand;
593
594 public NameValueCache(String versionSystemProperty, Uri uri, String callCommand) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800595 mVersionSystemProperty = versionSystemProperty;
596 mUri = uri;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800597 mCallCommand = callCommand;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800598 }
599
Dan Egnor799f7212009-11-24 16:24:44 -0800600 public String getString(ContentResolver cr, String name) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800601 long newValuesVersion = SystemProperties.getLong(mVersionSystemProperty, 0);
Dan Egnor799f7212009-11-24 16:24:44 -0800602
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800603 synchronized (this) {
Dan Egnor799f7212009-11-24 16:24:44 -0800604 if (mValuesVersion != newValuesVersion) {
605 if (LOCAL_LOGV) {
606 Log.v(TAG, "invalidate [" + mUri.getLastPathSegment() + "]: current " +
607 newValuesVersion + " != cached " + mValuesVersion);
608 }
609
610 mValues.clear();
611 mValuesVersion = newValuesVersion;
612 }
613
614 if (mValues.containsKey(name)) {
615 return mValues.get(name); // Could be null, that's OK -- negative caching
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800616 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800617 }
Dan Egnor799f7212009-11-24 16:24:44 -0800618
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800619 IContentProvider cp = null;
620 synchronized (this) {
621 cp = mContentProvider;
622 if (cp == null) {
623 cp = mContentProvider = cr.acquireProvider(mUri.getAuthority());
624 }
625 }
626
627 // Try the fast path first, not using query(). If this
628 // fails (alternate Settings provider that doesn't support
629 // this interface?) then we fall back to the query/table
630 // interface.
631 if (mCallCommand != null) {
632 try {
633 Bundle b = cp.call(mCallCommand, name, null);
634 if (b != null) {
635 String value = b.getPairValue();
636 synchronized (this) {
637 mValues.put(name, value);
638 }
639 return value;
640 }
641 // If the response Bundle is null, we fall through
642 // to the query interface below.
643 } catch (RemoteException e) {
644 // Not supported by the remote side? Fall through
645 // to query().
646 }
647 }
648
Dan Egnor799f7212009-11-24 16:24:44 -0800649 Cursor c = null;
650 try {
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800651 c = cp.query(mUri, SELECT_VALUE, NAME_EQ_PLACEHOLDER,
652 new String[]{name}, null);
Dan Egnor799f7212009-11-24 16:24:44 -0800653 if (c == null) {
654 Log.w(TAG, "Can't get key " + name + " from " + mUri);
655 return null;
656 }
657
658 String value = c.moveToNext() ? c.getString(0) : null;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800659 synchronized (this) {
Dan Egnor799f7212009-11-24 16:24:44 -0800660 mValues.put(name, value);
661 }
662 if (LOCAL_LOGV) {
663 Log.v(TAG, "cache miss [" + mUri.getLastPathSegment() + "]: " +
664 name + " = " + (value == null ? "(null)" : value));
665 }
666 return value;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800667 } catch (RemoteException e) {
Dan Egnor799f7212009-11-24 16:24:44 -0800668 Log.w(TAG, "Can't get key " + name + " from " + mUri, e);
669 return null; // Return null, but don't cache it.
670 } finally {
671 if (c != null) c.close();
672 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800673 }
674 }
675
676 /**
677 * System settings, containing miscellaneous system preferences. This
678 * table holds simple name/value pairs. There are convenience
679 * functions for accessing individual settings entries.
680 */
681 public static final class System extends NameValueTable {
682 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_system_version";
683
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800684 // Populated lazily, guarded by class object:
685 private static NameValueCache sNameValueCache = null;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700686
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800687 private static final HashSet<String> MOVED_TO_SECURE;
688 static {
689 MOVED_TO_SECURE = new HashSet<String>(30);
690 MOVED_TO_SECURE.add(Secure.ADB_ENABLED);
691 MOVED_TO_SECURE.add(Secure.ANDROID_ID);
692 MOVED_TO_SECURE.add(Secure.BLUETOOTH_ON);
693 MOVED_TO_SECURE.add(Secure.DATA_ROAMING);
694 MOVED_TO_SECURE.add(Secure.DEVICE_PROVISIONED);
695 MOVED_TO_SECURE.add(Secure.HTTP_PROXY);
696 MOVED_TO_SECURE.add(Secure.INSTALL_NON_MARKET_APPS);
697 MOVED_TO_SECURE.add(Secure.LOCATION_PROVIDERS_ALLOWED);
Amith Yamasani156c4352010-03-05 17:10:03 -0800698 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_ENABLED);
699 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_VISIBLE);
700 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800701 MOVED_TO_SECURE.add(Secure.LOGGING_ID);
702 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_ENABLED);
703 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_LAST_UPDATE);
704 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_REDIRECT_URL);
705 MOVED_TO_SECURE.add(Secure.SETTINGS_CLASSNAME);
706 MOVED_TO_SECURE.add(Secure.USB_MASS_STORAGE_ENABLED);
707 MOVED_TO_SECURE.add(Secure.USE_GOOGLE_MAIL);
708 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
709 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
710 MOVED_TO_SECURE.add(Secure.WIFI_NUM_OPEN_NETWORKS_KEPT);
711 MOVED_TO_SECURE.add(Secure.WIFI_ON);
712 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE);
713 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_AP_COUNT);
714 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS);
715 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED);
716 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS);
717 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT);
718 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_MAX_AP_CHECKS);
719 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ON);
720 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_COUNT);
721 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_DELAY_MS);
722 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS);
723 }
724
725 /**
726 * Look up a name in the database.
727 * @param resolver to access the database with
728 * @param name to look up in the table
729 * @return the corresponding value, or null if not present
730 */
731 public synchronized static String getString(ContentResolver resolver, String name) {
732 if (MOVED_TO_SECURE.contains(name)) {
733 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
734 + " to android.provider.Settings.Secure, returning read-only value.");
735 return Secure.getString(resolver, name);
736 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800737 if (sNameValueCache == null) {
738 sNameValueCache = new NameValueCache(SYS_PROP_SETTING_VERSION, CONTENT_URI,
739 CALL_METHOD_GET_SYSTEM);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800740 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -0800741 return sNameValueCache.getString(resolver, name);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800742 }
743
744 /**
745 * Store a name/value pair into the database.
746 * @param resolver to access the database with
747 * @param name to store
748 * @param value to associate with the name
749 * @return true if the value was set, false on database errors
750 */
751 public static boolean putString(ContentResolver resolver, String name, String value) {
752 if (MOVED_TO_SECURE.contains(name)) {
753 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
754 + " to android.provider.Settings.Secure, value is unchanged.");
755 return false;
756 }
757 return putString(resolver, CONTENT_URI, name, value);
758 }
759
760 /**
761 * Construct the content URI for a particular name/value pair,
762 * useful for monitoring changes with a ContentObserver.
763 * @param name to look up in the table
764 * @return the corresponding content URI, or null if not present
765 */
766 public static Uri getUriFor(String name) {
767 if (MOVED_TO_SECURE.contains(name)) {
768 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
769 + " to android.provider.Settings.Secure, returning Secure URI.");
770 return Secure.getUriFor(Secure.CONTENT_URI, name);
771 }
772 return getUriFor(CONTENT_URI, name);
773 }
774
775 /**
776 * Convenience function for retrieving a single system settings value
777 * as an integer. Note that internally setting values are always
778 * stored as strings; this function converts the string to an integer
779 * for you. The default value will be returned if the setting is
780 * not defined or not an integer.
781 *
782 * @param cr The ContentResolver to access.
783 * @param name The name of the setting to retrieve.
784 * @param def Value to return if the setting is not defined.
785 *
786 * @return The setting's current value, or 'def' if it is not defined
787 * or not a valid integer.
788 */
789 public static int getInt(ContentResolver cr, String name, int def) {
790 String v = getString(cr, name);
791 try {
792 return v != null ? Integer.parseInt(v) : def;
793 } catch (NumberFormatException e) {
794 return def;
795 }
796 }
797
798 /**
799 * Convenience function for retrieving a single system settings value
800 * as an integer. Note that internally setting values are always
801 * stored as strings; this function converts the string to an integer
802 * for you.
803 * <p>
804 * This version does not take a default value. If the setting has not
805 * been set, or the string value is not a number,
806 * it throws {@link SettingNotFoundException}.
807 *
808 * @param cr The ContentResolver to access.
809 * @param name The name of the setting to retrieve.
810 *
811 * @throws SettingNotFoundException Thrown if a setting by the given
812 * name can't be found or the setting value is not an integer.
813 *
814 * @return The setting's current value.
815 */
816 public static int getInt(ContentResolver cr, String name)
817 throws SettingNotFoundException {
818 String v = getString(cr, name);
819 try {
820 return Integer.parseInt(v);
821 } catch (NumberFormatException e) {
822 throw new SettingNotFoundException(name);
823 }
824 }
825
826 /**
827 * Convenience function for updating a single settings value as an
828 * integer. This will either create a new entry in the table if the
829 * given name does not exist, or modify the value of the existing row
830 * with that name. Note that internally setting values are always
831 * stored as strings, so this function converts the given value to a
832 * string before storing it.
833 *
834 * @param cr The ContentResolver to access.
835 * @param name The name of the setting to modify.
836 * @param value The new value for the setting.
837 * @return true if the value was set, false on database errors
838 */
839 public static boolean putInt(ContentResolver cr, String name, int value) {
840 return putString(cr, name, Integer.toString(value));
841 }
842
843 /**
844 * Convenience function for retrieving a single system settings value
845 * as a {@code long}. Note that internally setting values are always
846 * stored as strings; this function converts the string to a {@code long}
847 * for you. The default value will be returned if the setting is
848 * not defined or not a {@code long}.
849 *
850 * @param cr The ContentResolver to access.
851 * @param name The name of the setting to retrieve.
852 * @param def Value to return if the setting is not defined.
853 *
854 * @return The setting's current value, or 'def' if it is not defined
855 * or not a valid {@code long}.
856 */
857 public static long getLong(ContentResolver cr, String name, long def) {
858 String valString = getString(cr, name);
859 long value;
860 try {
861 value = valString != null ? Long.parseLong(valString) : def;
862 } catch (NumberFormatException e) {
863 value = def;
864 }
865 return value;
866 }
867
868 /**
869 * Convenience function for retrieving a single system settings value
870 * as a {@code long}. Note that internally setting values are always
871 * stored as strings; this function converts the string to a {@code long}
872 * for you.
873 * <p>
874 * This version does not take a default value. If the setting has not
875 * been set, or the string value is not a number,
876 * it throws {@link SettingNotFoundException}.
877 *
878 * @param cr The ContentResolver to access.
879 * @param name The name of the setting to retrieve.
880 *
881 * @return The setting's current value.
882 * @throws SettingNotFoundException Thrown if a setting by the given
883 * name can't be found or the setting value is not an integer.
884 */
885 public static long getLong(ContentResolver cr, String name)
886 throws SettingNotFoundException {
887 String valString = getString(cr, name);
888 try {
889 return Long.parseLong(valString);
890 } catch (NumberFormatException e) {
891 throw new SettingNotFoundException(name);
892 }
893 }
894
895 /**
896 * Convenience function for updating a single settings value as a long
897 * integer. This will either create a new entry in the table if the
898 * given name does not exist, or modify the value of the existing row
899 * with that name. Note that internally setting values are always
900 * stored as strings, so this function converts the given value to a
901 * string before storing it.
902 *
903 * @param cr The ContentResolver to access.
904 * @param name The name of the setting to modify.
905 * @param value The new value for the setting.
906 * @return true if the value was set, false on database errors
907 */
908 public static boolean putLong(ContentResolver cr, String name, long value) {
909 return putString(cr, name, Long.toString(value));
910 }
911
912 /**
913 * Convenience function for retrieving a single system settings value
914 * as a floating point number. Note that internally setting values are
915 * always stored as strings; this function converts the string to an
916 * float for you. The default value will be returned if the setting
917 * is not defined or not a valid float.
918 *
919 * @param cr The ContentResolver to access.
920 * @param name The name of the setting to retrieve.
921 * @param def Value to return if the setting is not defined.
922 *
923 * @return The setting's current value, or 'def' if it is not defined
924 * or not a valid float.
925 */
926 public static float getFloat(ContentResolver cr, String name, float def) {
927 String v = getString(cr, name);
928 try {
929 return v != null ? Float.parseFloat(v) : def;
930 } catch (NumberFormatException e) {
931 return def;
932 }
933 }
934
935 /**
936 * Convenience function for retrieving a single system settings value
937 * as a float. Note that internally setting values are always
938 * stored as strings; this function converts the string to a float
939 * for you.
940 * <p>
941 * This version does not take a default value. If the setting has not
942 * been set, or the string value is not a number,
943 * it throws {@link SettingNotFoundException}.
944 *
945 * @param cr The ContentResolver to access.
946 * @param name The name of the setting to retrieve.
947 *
948 * @throws SettingNotFoundException Thrown if a setting by the given
949 * name can't be found or the setting value is not a float.
950 *
951 * @return The setting's current value.
952 */
953 public static float getFloat(ContentResolver cr, String name)
954 throws SettingNotFoundException {
955 String v = getString(cr, name);
956 try {
957 return Float.parseFloat(v);
958 } catch (NumberFormatException e) {
959 throw new SettingNotFoundException(name);
960 }
961 }
962
963 /**
964 * Convenience function for updating a single settings value as a
965 * floating point number. This will either create a new entry in the
966 * table if the given name does not exist, or modify the value of the
967 * existing row with that name. Note that internally setting values
968 * are always stored as strings, so this function converts the given
969 * value to a string before storing it.
970 *
971 * @param cr The ContentResolver to access.
972 * @param name The name of the setting to modify.
973 * @param value The new value for the setting.
974 * @return true if the value was set, false on database errors
975 */
976 public static boolean putFloat(ContentResolver cr, String name, float value) {
977 return putString(cr, name, Float.toString(value));
978 }
979
980 /**
981 * Convenience function to read all of the current
982 * configuration-related settings into a
983 * {@link Configuration} object.
984 *
985 * @param cr The ContentResolver to access.
986 * @param outConfig Where to place the configuration settings.
987 */
988 public static void getConfiguration(ContentResolver cr, Configuration outConfig) {
989 outConfig.fontScale = Settings.System.getFloat(
990 cr, FONT_SCALE, outConfig.fontScale);
991 if (outConfig.fontScale < 0) {
992 outConfig.fontScale = 1;
993 }
994 }
995
996 /**
997 * Convenience function to write a batch of configuration-related
998 * settings from a {@link Configuration} object.
999 *
1000 * @param cr The ContentResolver to access.
1001 * @param config The settings to write.
1002 * @return true if the values were set, false on database errors
1003 */
1004 public static boolean putConfiguration(ContentResolver cr, Configuration config) {
1005 return Settings.System.putFloat(cr, FONT_SCALE, config.fontScale);
1006 }
1007
Dianne Hackbornb8b11a02010-03-10 15:53:11 -08001008 /** @hide */
1009 public static boolean hasInterestingConfigurationChanges(int changes) {
1010 return (changes&ActivityInfo.CONFIG_FONT_SCALE) != 0;
1011 }
1012
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001013 public static boolean getShowGTalkServiceStatus(ContentResolver cr) {
1014 return getInt(cr, SHOW_GTALK_SERVICE_STATUS, 0) != 0;
1015 }
1016
1017 public static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag) {
1018 putInt(cr, SHOW_GTALK_SERVICE_STATUS, flag ? 1 : 0);
1019 }
1020
1021 /**
1022 * The content:// style URL for this table
1023 */
1024 public static final Uri CONTENT_URI =
1025 Uri.parse("content://" + AUTHORITY + "/system");
1026
1027 /**
1028 * Whether we keep the device on while the device is plugged in.
1029 * Supported values are:
1030 * <ul>
1031 * <li>{@code 0} to never stay on while plugged in</li>
1032 * <li>{@link BatteryManager#BATTERY_PLUGGED_AC} to stay on for AC charger</li>
1033 * <li>{@link BatteryManager#BATTERY_PLUGGED_USB} to stay on for USB charger</li>
1034 * </ul>
1035 * These values can be OR-ed together.
1036 */
1037 public static final String STAY_ON_WHILE_PLUGGED_IN = "stay_on_while_plugged_in";
1038
1039 /**
1040 * What happens when the user presses the end call button if they're not
1041 * on a call.<br/>
1042 * <b>Values:</b><br/>
1043 * 0 - The end button does nothing.<br/>
1044 * 1 - The end button goes to the home screen.<br/>
1045 * 2 - The end button puts the device to sleep and locks the keyguard.<br/>
1046 * 3 - The end button goes to the home screen. If the user is already on the
1047 * home screen, it puts the device to sleep.
1048 */
1049 public static final String END_BUTTON_BEHAVIOR = "end_button_behavior";
1050
1051 /**
David Brown458e8062010-03-08 21:52:11 -08001052 * END_BUTTON_BEHAVIOR value for "go home".
1053 * @hide
1054 */
1055 public static final int END_BUTTON_BEHAVIOR_HOME = 0x1;
1056
1057 /**
1058 * END_BUTTON_BEHAVIOR value for "go to sleep".
1059 * @hide
1060 */
1061 public static final int END_BUTTON_BEHAVIOR_SLEEP = 0x2;
1062
1063 /**
1064 * END_BUTTON_BEHAVIOR default value.
1065 * @hide
1066 */
1067 public static final int END_BUTTON_BEHAVIOR_DEFAULT = END_BUTTON_BEHAVIOR_SLEEP;
1068
1069 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001070 * Whether Airplane Mode is on.
1071 */
1072 public static final String AIRPLANE_MODE_ON = "airplane_mode_on";
1073
1074 /**
1075 * Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
1076 */
1077 public static final String RADIO_BLUETOOTH = "bluetooth";
1078
1079 /**
1080 * Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
1081 */
1082 public static final String RADIO_WIFI = "wifi";
1083
1084 /**
1085 * Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
1086 */
1087 public static final String RADIO_CELL = "cell";
1088
1089 /**
1090 * A comma separated list of radios that need to be disabled when airplane mode
1091 * is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are
1092 * included in the comma separated list.
1093 */
1094 public static final String AIRPLANE_MODE_RADIOS = "airplane_mode_radios";
1095
1096 /**
Mike Lockwoodbd5ddf02009-07-29 21:37:14 -07001097 * A comma separated list of radios that should to be disabled when airplane mode
1098 * is on, but can be manually reenabled by the user. For example, if RADIO_WIFI is
1099 * added to both AIRPLANE_MODE_RADIOS and AIRPLANE_MODE_TOGGLEABLE_RADIOS, then Wifi
1100 * will be turned off when entering airplane mode, but the user will be able to reenable
1101 * Wifi in the Settings app.
1102 *
1103 * {@hide}
1104 */
1105 public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS = "airplane_mode_toggleable_radios";
1106
1107 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001108 * The policy for deciding when Wi-Fi should go to sleep (which will in
1109 * turn switch to using the mobile data as an Internet connection).
1110 * <p>
1111 * Set to one of {@link #WIFI_SLEEP_POLICY_DEFAULT},
1112 * {@link #WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED}, or
1113 * {@link #WIFI_SLEEP_POLICY_NEVER}.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001114 */
1115 public static final String WIFI_SLEEP_POLICY = "wifi_sleep_policy";
1116
1117 /**
1118 * Value for {@link #WIFI_SLEEP_POLICY} to use the default Wi-Fi sleep
1119 * policy, which is to sleep shortly after the turning off
1120 * according to the {@link #STAY_ON_WHILE_PLUGGED_IN} setting.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001121 */
1122 public static final int WIFI_SLEEP_POLICY_DEFAULT = 0;
1123
1124 /**
1125 * Value for {@link #WIFI_SLEEP_POLICY} to use the default policy when
1126 * the device is on battery, and never go to sleep when the device is
1127 * plugged in.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001128 */
1129 public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED = 1;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001130
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001131 /**
1132 * Value for {@link #WIFI_SLEEP_POLICY} to never go to sleep.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001133 */
1134 public static final int WIFI_SLEEP_POLICY_NEVER = 2;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001135
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001136 /**
1137 * Whether to use static IP and other static network attributes.
1138 * <p>
1139 * Set to 1 for true and 0 for false.
1140 */
1141 public static final String WIFI_USE_STATIC_IP = "wifi_use_static_ip";
1142
1143 /**
1144 * The static IP address.
1145 * <p>
1146 * Example: "192.168.1.51"
1147 */
1148 public static final String WIFI_STATIC_IP = "wifi_static_ip";
1149
1150 /**
1151 * If using static IP, the gateway's IP address.
1152 * <p>
1153 * Example: "192.168.1.1"
1154 */
1155 public static final String WIFI_STATIC_GATEWAY = "wifi_static_gateway";
1156
1157 /**
1158 * If using static IP, the net mask.
1159 * <p>
1160 * Example: "255.255.255.0"
1161 */
1162 public static final String WIFI_STATIC_NETMASK = "wifi_static_netmask";
1163
1164 /**
1165 * If using static IP, the primary DNS's IP address.
1166 * <p>
1167 * Example: "192.168.1.1"
1168 */
1169 public static final String WIFI_STATIC_DNS1 = "wifi_static_dns1";
1170
1171 /**
1172 * If using static IP, the secondary DNS's IP address.
1173 * <p>
1174 * Example: "192.168.1.2"
1175 */
1176 public static final String WIFI_STATIC_DNS2 = "wifi_static_dns2";
1177
1178 /**
1179 * The number of radio channels that are allowed in the local
1180 * 802.11 regulatory domain.
1181 * @hide
1182 */
1183 public static final String WIFI_NUM_ALLOWED_CHANNELS = "wifi_num_allowed_channels";
1184
1185 /**
1186 * Determines whether remote devices may discover and/or connect to
1187 * this device.
1188 * <P>Type: INT</P>
1189 * 2 -- discoverable and connectable
1190 * 1 -- connectable but not discoverable
1191 * 0 -- neither connectable nor discoverable
1192 */
1193 public static final String BLUETOOTH_DISCOVERABILITY =
1194 "bluetooth_discoverability";
1195
1196 /**
1197 * Bluetooth discoverability timeout. If this value is nonzero, then
1198 * Bluetooth becomes discoverable for a certain number of seconds,
1199 * after which is becomes simply connectable. The value is in seconds.
1200 */
1201 public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT =
1202 "bluetooth_discoverability_timeout";
1203
1204 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08001205 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_ENABLED}
1206 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001207 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001208 @Deprecated
1209 public static final String LOCK_PATTERN_ENABLED = Secure.LOCK_PATTERN_ENABLED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001210
1211 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08001212 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_VISIBLE}
1213 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001214 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001215 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001216 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
1217
1218 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08001219 * @deprecated Use
1220 * {@link android.provider.Settings.Secure#LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED}
1221 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001222 */
Amith Yamasani156c4352010-03-05 17:10:03 -08001223 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001224 public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
1225 "lock_pattern_tactile_feedback_enabled";
1226
1227
1228 /**
1229 * A formatted string of the next alarm that is set, or the empty string
1230 * if there is no alarm set.
1231 */
1232 public static final String NEXT_ALARM_FORMATTED = "next_alarm_formatted";
1233
1234 /**
1235 * Scaling factor for fonts, float.
1236 */
1237 public static final String FONT_SCALE = "font_scale";
1238
1239 /**
1240 * Name of an application package to be debugged.
1241 */
1242 public static final String DEBUG_APP = "debug_app";
1243
1244 /**
1245 * If 1, when launching DEBUG_APP it will wait for the debugger before
1246 * starting user code. If 0, it will run normally.
1247 */
1248 public static final String WAIT_FOR_DEBUGGER = "wait_for_debugger";
1249
1250 /**
1251 * Whether or not to dim the screen. 0=no 1=yes
1252 */
1253 public static final String DIM_SCREEN = "dim_screen";
1254
1255 /**
1256 * The timeout before the screen turns off.
1257 */
1258 public static final String SCREEN_OFF_TIMEOUT = "screen_off_timeout";
1259
1260 /**
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -07001261 * If 0, the compatibility mode is off for all applications.
1262 * If 1, older applications run under compatibility mode.
1263 * TODO: remove this settings before code freeze (bug/1907571)
1264 * @hide
1265 */
1266 public static final String COMPATIBILITY_MODE = "compatibility_mode";
1267
1268 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001269 * The screen backlight brightness between 0 and 255.
1270 */
1271 public static final String SCREEN_BRIGHTNESS = "screen_brightness";
1272
1273 /**
Dan Murphy951764b2009-08-27 14:59:03 -05001274 * Control whether to enable automatic brightness mode.
Dan Murphy951764b2009-08-27 14:59:03 -05001275 */
1276 public static final String SCREEN_BRIGHTNESS_MODE = "screen_brightness_mode";
1277
1278 /**
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001279 * SCREEN_BRIGHTNESS_MODE value for manual mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001280 */
1281 public static final int SCREEN_BRIGHTNESS_MODE_MANUAL = 0;
1282
1283 /**
1284 * SCREEN_BRIGHTNESS_MODE value for manual mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07001285 */
1286 public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC = 1;
1287
1288 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001289 * Control whether the process CPU usage meter should be shown.
1290 */
1291 public static final String SHOW_PROCESSES = "show_processes";
1292
1293 /**
1294 * If 1, the activity manager will aggressively finish activities and
1295 * processes as soon as they are no longer needed. If 0, the normal
1296 * extended lifetime is used.
1297 */
1298 public static final String ALWAYS_FINISH_ACTIVITIES =
1299 "always_finish_activities";
1300
1301
1302 /**
1303 * Ringer mode. This is used internally, changing this value will not
1304 * change the ringer mode. See AudioManager.
1305 */
1306 public static final String MODE_RINGER = "mode_ringer";
1307
1308 /**
1309 * Determines which streams are affected by ringer mode changes. The
1310 * stream type's bit should be set to 1 if it should be muted when going
1311 * into an inaudible ringer mode.
1312 */
1313 public static final String MODE_RINGER_STREAMS_AFFECTED = "mode_ringer_streams_affected";
1314
1315 /**
1316 * Determines which streams are affected by mute. The
1317 * stream type's bit should be set to 1 if it should be muted when a mute request
1318 * is received.
1319 */
1320 public static final String MUTE_STREAMS_AFFECTED = "mute_streams_affected";
1321
1322 /**
1323 * Whether vibrate is on for different events. This is used internally,
1324 * changing this value will not change the vibrate. See AudioManager.
1325 */
1326 public static final String VIBRATE_ON = "vibrate_on";
1327
1328 /**
1329 * Ringer volume. This is used internally, changing this value will not
1330 * change the volume. See AudioManager.
1331 */
1332 public static final String VOLUME_RING = "volume_ring";
1333
1334 /**
1335 * System/notifications volume. This is used internally, changing this
1336 * value will not change the volume. See AudioManager.
1337 */
1338 public static final String VOLUME_SYSTEM = "volume_system";
1339
1340 /**
1341 * Voice call volume. This is used internally, changing this value will
1342 * not change the volume. See AudioManager.
1343 */
1344 public static final String VOLUME_VOICE = "volume_voice";
1345
1346 /**
1347 * Music/media/gaming volume. This is used internally, changing this
1348 * value will not change the volume. See AudioManager.
1349 */
1350 public static final String VOLUME_MUSIC = "volume_music";
1351
1352 /**
1353 * Alarm volume. This is used internally, changing this
1354 * value will not change the volume. See AudioManager.
1355 */
1356 public static final String VOLUME_ALARM = "volume_alarm";
1357
1358 /**
1359 * Notification volume. This is used internally, changing this
1360 * value will not change the volume. See AudioManager.
1361 */
1362 public static final String VOLUME_NOTIFICATION = "volume_notification";
1363
1364 /**
Eric Laurent484d2882009-12-08 09:05:45 -08001365 * Bluetooth Headset volume. This is used internally, changing this value will
1366 * not change the volume. See AudioManager.
1367 */
1368 public static final String VOLUME_BLUETOOTH_SCO = "volume_bluetooth_sco";
1369
1370 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001371 * Whether the notifications should use the ring volume (value of 1) or
1372 * a separate notification volume (value of 0). In most cases, users
1373 * will have this enabled so the notification and ringer volumes will be
1374 * the same. However, power users can disable this and use the separate
1375 * notification volume control.
1376 * <p>
1377 * Note: This is a one-off setting that will be removed in the future
1378 * when there is profile support. For this reason, it is kept hidden
1379 * from the public APIs.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001380 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001381 * @hide
1382 */
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001383 public static final String NOTIFICATIONS_USE_RING_VOLUME =
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001384 "notifications_use_ring_volume";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001385
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001386 /**
Daniel Sandler6329bf72010-02-26 15:17:44 -05001387 * Whether silent mode should allow vibration feedback. This is used
1388 * internally in AudioService and the Sound settings activity to
1389 * coordinate decoupling of vibrate and silent modes. This setting
1390 * will likely be removed in a future release with support for
1391 * audio/vibe feedback profiles.
1392 *
1393 * @hide
1394 */
1395 public static final String VIBRATE_IN_SILENT = "vibrate_in_silent";
1396
1397 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001398 * The mapping of stream type (integer) to its setting.
1399 */
1400 public static final String[] VOLUME_SETTINGS = {
1401 VOLUME_VOICE, VOLUME_SYSTEM, VOLUME_RING, VOLUME_MUSIC,
Eric Laurent484d2882009-12-08 09:05:45 -08001402 VOLUME_ALARM, VOLUME_NOTIFICATION, VOLUME_BLUETOOTH_SCO
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001403 };
1404
1405 /**
1406 * Appended to various volume related settings to record the previous
1407 * values before they the settings were affected by a silent/vibrate
1408 * ringer mode change.
1409 */
1410 public static final String APPEND_FOR_LAST_AUDIBLE = "_last_audible";
1411
1412 /**
1413 * Persistent store for the system-wide default ringtone URI.
1414 * <p>
1415 * If you need to play the default ringtone at any given time, it is recommended
1416 * you give {@link #DEFAULT_RINGTONE_URI} to the media player. It will resolve
1417 * to the set default ringtone at the time of playing.
1418 *
1419 * @see #DEFAULT_RINGTONE_URI
1420 */
1421 public static final String RINGTONE = "ringtone";
1422
1423 /**
1424 * A {@link Uri} that will point to the current default ringtone at any
1425 * given time.
1426 * <p>
1427 * If the current default ringtone is in the DRM provider and the caller
1428 * does not have permission, the exception will be a
1429 * FileNotFoundException.
1430 */
1431 public static final Uri DEFAULT_RINGTONE_URI = getUriFor(RINGTONE);
1432
1433 /**
1434 * Persistent store for the system-wide default notification sound.
1435 *
1436 * @see #RINGTONE
1437 * @see #DEFAULT_NOTIFICATION_URI
1438 */
1439 public static final String NOTIFICATION_SOUND = "notification_sound";
1440
1441 /**
1442 * A {@link Uri} that will point to the current default notification
1443 * sound at any given time.
1444 *
1445 * @see #DEFAULT_RINGTONE_URI
1446 */
1447 public static final Uri DEFAULT_NOTIFICATION_URI = getUriFor(NOTIFICATION_SOUND);
1448
1449 /**
Patrick Scott3156bb002009-04-13 09:57:38 -07001450 * Persistent store for the system-wide default alarm alert.
1451 *
1452 * @see #RINGTONE
1453 * @see #DEFAULT_ALARM_ALERT_URI
1454 */
1455 public static final String ALARM_ALERT = "alarm_alert";
1456
1457 /**
1458 * A {@link Uri} that will point to the current default alarm alert at
1459 * any given time.
1460 *
1461 * @see #DEFAULT_ALARM_ALERT_URI
1462 */
1463 public static final Uri DEFAULT_ALARM_ALERT_URI = getUriFor(ALARM_ALERT);
1464
1465 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001466 * Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off
1467 */
1468 public static final String TEXT_AUTO_REPLACE = "auto_replace";
1469
1470 /**
1471 * Setting to enable Auto Caps in text editors. 1 = On, 0 = Off
1472 */
1473 public static final String TEXT_AUTO_CAPS = "auto_caps";
1474
1475 /**
1476 * Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This
1477 * feature converts two spaces to a "." and space.
1478 */
1479 public static final String TEXT_AUTO_PUNCTUATE = "auto_punctuate";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001480
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001481 /**
1482 * Setting to showing password characters in text editors. 1 = On, 0 = Off
1483 */
1484 public static final String TEXT_SHOW_PASSWORD = "show_password";
1485
1486 public static final String SHOW_GTALK_SERVICE_STATUS =
1487 "SHOW_GTALK_SERVICE_STATUS";
1488
1489 /**
1490 * Name of activity to use for wallpaper on the home screen.
1491 */
1492 public static final String WALLPAPER_ACTIVITY = "wallpaper_activity";
1493
1494 /**
1495 * Value to specify if the user prefers the date, time and time zone
1496 * to be automatically fetched from the network (NITZ). 1=yes, 0=no
1497 */
1498 public static final String AUTO_TIME = "auto_time";
1499
1500 /**
1501 * Display times as 12 or 24 hours
1502 * 12
1503 * 24
1504 */
1505 public static final String TIME_12_24 = "time_12_24";
1506
1507 /**
1508 * Date format string
1509 * mm/dd/yyyy
1510 * dd/mm/yyyy
1511 * yyyy/mm/dd
1512 */
1513 public static final String DATE_FORMAT = "date_format";
1514
1515 /**
1516 * Whether the setup wizard has been run before (on first boot), or if
1517 * it still needs to be run.
1518 *
1519 * nonzero = it has been run in the past
1520 * 0 = it has not been run in the past
1521 */
1522 public static final String SETUP_WIZARD_HAS_RUN = "setup_wizard_has_run";
1523
1524 /**
1525 * Scaling factor for normal window animations. Setting to 0 will disable window
1526 * animations.
1527 */
1528 public static final String WINDOW_ANIMATION_SCALE = "window_animation_scale";
1529
1530 /**
1531 * Scaling factor for activity transition animations. Setting to 0 will disable window
1532 * animations.
1533 */
1534 public static final String TRANSITION_ANIMATION_SCALE = "transition_animation_scale";
1535
1536 /**
1537 * Scaling factor for normal window animations. Setting to 0 will disable window
1538 * animations.
1539 * @hide
1540 */
1541 public static final String FANCY_IME_ANIMATIONS = "fancy_ime_animations";
1542
1543 /**
1544 * Control whether the accelerometer will be used to change screen
1545 * orientation. If 0, it will not be used unless explicitly requested
1546 * by the application; if 1, it will be used by default unless explicitly
1547 * disabled by the application.
1548 */
1549 public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
1550
1551 /**
1552 * Whether the audible DTMF tones are played by the dialer when dialing. The value is
1553 * boolean (1 or 0).
1554 */
1555 public static final String DTMF_TONE_WHEN_DIALING = "dtmf_tone";
1556
1557 /**
David Kraused0f67152009-06-13 18:01:13 -05001558 * CDMA only settings
1559 * DTMF tone type played by the dialer when dialing.
1560 * 0 = Normal
1561 * 1 = Long
1562 * @hide
1563 */
1564 public static final String DTMF_TONE_TYPE_WHEN_DIALING = "dtmf_tone_type";
1565
1566 /**
1567 * CDMA only settings
1568 * Emergency Tone 0 = Off
1569 * 1 = Alert
1570 * 2 = Vibrate
1571 * @hide
1572 */
1573 public static final String EMERGENCY_TONE = "emergency_tone";
1574
1575 /**
1576 * CDMA only settings
1577 * Whether the auto retry is enabled. The value is
1578 * boolean (1 or 0).
1579 * @hide
1580 */
1581 public static final String CALL_AUTO_RETRY = "call_auto_retry";
1582
1583 /**
1584 * Whether the hearing aid is enabled. The value is
1585 * boolean (1 or 0).
1586 * @hide
1587 */
1588 public static final String HEARING_AID = "hearing_aid";
1589
1590 /**
1591 * CDMA only settings
1592 * TTY Mode
1593 * 0 = OFF
1594 * 1 = FULL
1595 * 2 = VCO
1596 * 3 = HCO
1597 * @hide
1598 */
1599 public static final String TTY_MODE = "tty_mode";
1600
1601 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001602 * Whether the sounds effects (key clicks, lid open ...) are enabled. The value is
1603 * boolean (1 or 0).
1604 */
1605 public static final String SOUND_EFFECTS_ENABLED = "sound_effects_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001606
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001607 /**
1608 * Whether the haptic feedback (long presses, ...) are enabled. The value is
1609 * boolean (1 or 0).
1610 */
1611 public static final String HAPTIC_FEEDBACK_ENABLED = "haptic_feedback_enabled";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07001612
Mike LeBeau48603e72009-06-05 00:27:00 +01001613 /**
1614 * Whether live web suggestions while the user types into search dialogs are
1615 * enabled. Browsers and other search UIs should respect this, as it allows
1616 * a user to avoid sending partial queries to a search engine, if it poses
1617 * any privacy concern. The value is boolean (1 or 0).
1618 */
1619 public static final String SHOW_WEB_SUGGESTIONS = "show_web_suggestions";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001620
-b master501eec92009-07-06 13:53:11 -07001621 /**
Amith Yamasaniae3ed702009-12-01 19:02:05 -08001622 * Whether the notification LED should repeatedly flash when a notification is
1623 * pending. The value is boolean (1 or 0).
1624 * @hide
1625 */
1626 public static final String NOTIFICATION_LIGHT_PULSE = "notification_light_pulse";
1627
1628 /**
Dianne Hackborn90d2db32010-02-11 22:19:06 -08001629 * Show pointer location on screen?
1630 * 0 = no
1631 * 1 = yes
1632 * @hide
1633 */
1634 public static final String POINTER_LOCATION = "pointer_location";
1635
1636 /**
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05001637 * Whether to play a sound for low-battery alerts.
1638 * @hide
1639 */
1640 public static final String POWER_SOUNDS_ENABLED = "power_sounds_enabled";
1641
1642 /**
1643 * Whether to play a sound for dock events.
1644 * @hide
1645 */
1646 public static final String DOCK_SOUNDS_ENABLED = "dock_sounds_enabled";
1647
1648 /**
1649 * Whether to play sounds when the keyguard is shown and dismissed.
1650 * @hide
1651 */
1652 public static final String LOCKSCREEN_SOUNDS_ENABLED = "lockscreen_sounds_enabled";
1653
1654 /**
1655 * URI for the low battery sound file.
1656 * @hide
1657 */
1658 public static final String LOW_BATTERY_SOUND = "low_battery_sound";
1659
1660 /**
1661 * URI for the desk dock "in" event sound.
1662 * @hide
1663 */
1664 public static final String DESK_DOCK_SOUND = "desk_dock_sound";
1665
1666 /**
1667 * URI for the desk dock "out" event sound.
1668 * @hide
1669 */
1670 public static final String DESK_UNDOCK_SOUND = "desk_undock_sound";
1671
1672 /**
1673 * URI for the car dock "in" event sound.
1674 * @hide
1675 */
1676 public static final String CAR_DOCK_SOUND = "car_dock_sound";
1677
1678 /**
1679 * URI for the car dock "out" event sound.
1680 * @hide
1681 */
1682 public static final String CAR_UNDOCK_SOUND = "car_undock_sound";
1683
1684 /**
1685 * URI for the "device locked" (keyguard shown) sound.
1686 * @hide
1687 */
1688 public static final String LOCK_SOUND = "lock_sound";
1689
1690 /**
1691 * URI for the "device unlocked" (keyguard dismissed) sound.
1692 * @hide
1693 */
1694 public static final String UNLOCK_SOUND = "unlock_sound";
1695
1696 /**
-b master501eec92009-07-06 13:53:11 -07001697 * Settings to backup. This is here so that it's in the same place as the settings
1698 * keys and easy to update.
1699 * @hide
1700 */
1701 public static final String[] SETTINGS_TO_BACKUP = {
1702 STAY_ON_WHILE_PLUGGED_IN,
-b master501eec92009-07-06 13:53:11 -07001703 WIFI_SLEEP_POLICY,
1704 WIFI_USE_STATIC_IP,
1705 WIFI_STATIC_IP,
1706 WIFI_STATIC_GATEWAY,
1707 WIFI_STATIC_NETMASK,
1708 WIFI_STATIC_DNS1,
1709 WIFI_STATIC_DNS2,
1710 BLUETOOTH_DISCOVERABILITY,
1711 BLUETOOTH_DISCOVERABILITY_TIMEOUT,
1712 DIM_SCREEN,
1713 SCREEN_OFF_TIMEOUT,
1714 SCREEN_BRIGHTNESS,
Christopher Tate362aca62009-09-25 15:58:03 -07001715 SCREEN_BRIGHTNESS_MODE,
-b master501eec92009-07-06 13:53:11 -07001716 VIBRATE_ON,
1717 NOTIFICATIONS_USE_RING_VOLUME,
Amith Yamasani8823c0a82009-07-07 14:30:17 -07001718 MODE_RINGER,
1719 MODE_RINGER_STREAMS_AFFECTED,
1720 MUTE_STREAMS_AFFECTED,
1721 VOLUME_VOICE,
1722 VOLUME_SYSTEM,
1723 VOLUME_RING,
1724 VOLUME_MUSIC,
1725 VOLUME_ALARM,
1726 VOLUME_NOTIFICATION,
Eric Laurent484d2882009-12-08 09:05:45 -08001727 VOLUME_BLUETOOTH_SCO,
Amith Yamasani8823c0a82009-07-07 14:30:17 -07001728 VOLUME_VOICE + APPEND_FOR_LAST_AUDIBLE,
1729 VOLUME_SYSTEM + APPEND_FOR_LAST_AUDIBLE,
1730 VOLUME_RING + APPEND_FOR_LAST_AUDIBLE,
1731 VOLUME_MUSIC + APPEND_FOR_LAST_AUDIBLE,
1732 VOLUME_ALARM + APPEND_FOR_LAST_AUDIBLE,
1733 VOLUME_NOTIFICATION + APPEND_FOR_LAST_AUDIBLE,
Eric Laurent484d2882009-12-08 09:05:45 -08001734 VOLUME_BLUETOOTH_SCO + APPEND_FOR_LAST_AUDIBLE,
Daniel Sandler1c7fa482010-03-10 09:45:01 -05001735 VIBRATE_IN_SILENT,
-b master501eec92009-07-06 13:53:11 -07001736 TEXT_AUTO_REPLACE,
1737 TEXT_AUTO_CAPS,
1738 TEXT_AUTO_PUNCTUATE,
1739 TEXT_SHOW_PASSWORD,
1740 AUTO_TIME,
1741 TIME_12_24,
1742 DATE_FORMAT,
1743 ACCELEROMETER_ROTATION,
1744 DTMF_TONE_WHEN_DIALING,
1745 DTMF_TONE_TYPE_WHEN_DIALING,
1746 EMERGENCY_TONE,
1747 CALL_AUTO_RETRY,
1748 HEARING_AID,
1749 TTY_MODE,
1750 SOUND_EFFECTS_ENABLED,
1751 HAPTIC_FEEDBACK_ENABLED,
Christopher Tate14c2d792010-02-25 16:49:44 -08001752 POWER_SOUNDS_ENABLED,
1753 DOCK_SOUNDS_ENABLED,
1754 LOCKSCREEN_SOUNDS_ENABLED,
Amith Yamasaniae3ed702009-12-01 19:02:05 -08001755 SHOW_WEB_SUGGESTIONS,
1756 NOTIFICATION_LIGHT_PULSE
-b master501eec92009-07-06 13:53:11 -07001757 };
1758
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001759 // Settings moved to Settings.Secure
1760
1761 /**
Mike Lockwood460ae0c2009-04-02 22:33:27 -07001762 * @deprecated Use {@link android.provider.Settings.Secure#ADB_ENABLED}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001763 * instead
1764 */
1765 @Deprecated
1766 public static final String ADB_ENABLED = Secure.ADB_ENABLED;
1767
1768 /**
1769 * @deprecated Use {@link android.provider.Settings.Secure#ANDROID_ID} instead
1770 */
1771 @Deprecated
1772 public static final String ANDROID_ID = Secure.ANDROID_ID;
1773
1774 /**
1775 * @deprecated Use {@link android.provider.Settings.Secure#BLUETOOTH_ON} instead
1776 */
1777 @Deprecated
1778 public static final String BLUETOOTH_ON = Secure.BLUETOOTH_ON;
1779
1780 /**
1781 * @deprecated Use {@link android.provider.Settings.Secure#DATA_ROAMING} instead
1782 */
1783 @Deprecated
1784 public static final String DATA_ROAMING = Secure.DATA_ROAMING;
1785
1786 /**
1787 * @deprecated Use {@link android.provider.Settings.Secure#DEVICE_PROVISIONED} instead
1788 */
1789 @Deprecated
1790 public static final String DEVICE_PROVISIONED = Secure.DEVICE_PROVISIONED;
1791
1792 /**
1793 * @deprecated Use {@link android.provider.Settings.Secure#HTTP_PROXY} instead
1794 */
1795 @Deprecated
1796 public static final String HTTP_PROXY = Secure.HTTP_PROXY;
1797
1798 /**
1799 * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
1800 */
1801 @Deprecated
1802 public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001803
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001804 /**
1805 * @deprecated Use {@link android.provider.Settings.Secure#LOCATION_PROVIDERS_ALLOWED}
1806 * instead
1807 */
1808 @Deprecated
1809 public static final String LOCATION_PROVIDERS_ALLOWED = Secure.LOCATION_PROVIDERS_ALLOWED;
1810
1811 /**
1812 * @deprecated Use {@link android.provider.Settings.Secure#LOGGING_ID} instead
1813 */
1814 @Deprecated
1815 public static final String LOGGING_ID = Secure.LOGGING_ID;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001816
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001817 /**
1818 * @deprecated Use {@link android.provider.Settings.Secure#NETWORK_PREFERENCE} instead
1819 */
1820 @Deprecated
1821 public static final String NETWORK_PREFERENCE = Secure.NETWORK_PREFERENCE;
1822
1823 /**
1824 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_ENABLED}
1825 * instead
1826 */
1827 @Deprecated
1828 public static final String PARENTAL_CONTROL_ENABLED = Secure.PARENTAL_CONTROL_ENABLED;
1829
1830 /**
1831 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_LAST_UPDATE}
1832 * instead
1833 */
1834 @Deprecated
1835 public static final String PARENTAL_CONTROL_LAST_UPDATE = Secure.PARENTAL_CONTROL_LAST_UPDATE;
1836
1837 /**
1838 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_REDIRECT_URL}
1839 * instead
1840 */
1841 @Deprecated
1842 public static final String PARENTAL_CONTROL_REDIRECT_URL =
1843 Secure.PARENTAL_CONTROL_REDIRECT_URL;
1844
1845 /**
1846 * @deprecated Use {@link android.provider.Settings.Secure#SETTINGS_CLASSNAME} instead
1847 */
1848 @Deprecated
1849 public static final String SETTINGS_CLASSNAME = Secure.SETTINGS_CLASSNAME;
1850
1851 /**
1852 * @deprecated Use {@link android.provider.Settings.Secure#USB_MASS_STORAGE_ENABLED} instead
1853 */
1854 @Deprecated
1855 public static final String USB_MASS_STORAGE_ENABLED = Secure.USB_MASS_STORAGE_ENABLED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001856
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001857 /**
1858 * @deprecated Use {@link android.provider.Settings.Secure#USE_GOOGLE_MAIL} instead
1859 */
1860 @Deprecated
1861 public static final String USE_GOOGLE_MAIL = Secure.USE_GOOGLE_MAIL;
1862
Dianne Hackborn4a51c202009-08-21 15:14:02 -07001863 /**
1864 * @deprecated Use
1865 * {@link android.provider.Settings.Secure#WIFI_MAX_DHCP_RETRY_COUNT} instead
1866 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001867 @Deprecated
1868 public static final String WIFI_MAX_DHCP_RETRY_COUNT = Secure.WIFI_MAX_DHCP_RETRY_COUNT;
1869
Dianne Hackborn4a51c202009-08-21 15:14:02 -07001870 /**
1871 * @deprecated Use
1872 * {@link android.provider.Settings.Secure#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
1873 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001874 @Deprecated
1875 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
1876 Secure.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
1877
1878 /**
1879 * @deprecated Use
1880 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON} instead
1881 */
1882 @Deprecated
1883 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
1884 Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
1885
1886 /**
1887 * @deprecated Use
1888 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} instead
1889 */
1890 @Deprecated
1891 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
1892 Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001893
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001894 /**
1895 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_NUM_OPEN_NETWORKS_KEPT}
1896 * instead
1897 */
1898 @Deprecated
1899 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = Secure.WIFI_NUM_OPEN_NETWORKS_KEPT;
1900
1901 /**
1902 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_ON} instead
1903 */
1904 @Deprecated
1905 public static final String WIFI_ON = Secure.WIFI_ON;
1906
1907 /**
1908 * @deprecated Use
1909 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE}
1910 * instead
1911 */
1912 @Deprecated
1913 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
1914 Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE;
1915
1916 /**
1917 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_AP_COUNT} instead
1918 */
1919 @Deprecated
1920 public static final String WIFI_WATCHDOG_AP_COUNT = Secure.WIFI_WATCHDOG_AP_COUNT;
1921
1922 /**
1923 * @deprecated Use
1924 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS} instead
1925 */
1926 @Deprecated
1927 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
1928 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001929
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001930 /**
1931 * @deprecated Use
1932 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED} instead
1933 */
1934 @Deprecated
1935 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
1936 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED;
1937
1938 /**
1939 * @deprecated Use
1940 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS}
1941 * instead
1942 */
1943 @Deprecated
1944 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
1945 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS;
1946
1947 /**
1948 * @deprecated Use
1949 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT} instead
1950 */
1951 @Deprecated
1952 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
1953 Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT;
1954
1955 /**
1956 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_MAX_AP_CHECKS}
1957 * instead
1958 */
1959 @Deprecated
1960 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = Secure.WIFI_WATCHDOG_MAX_AP_CHECKS;
1961
1962 /**
1963 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ON} instead
1964 */
1965 @Deprecated
1966 public static final String WIFI_WATCHDOG_ON = Secure.WIFI_WATCHDOG_ON;
1967
1968 /**
1969 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_COUNT} instead
1970 */
1971 @Deprecated
1972 public static final String WIFI_WATCHDOG_PING_COUNT = Secure.WIFI_WATCHDOG_PING_COUNT;
1973
1974 /**
1975 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_DELAY_MS}
1976 * instead
1977 */
1978 @Deprecated
1979 public static final String WIFI_WATCHDOG_PING_DELAY_MS = Secure.WIFI_WATCHDOG_PING_DELAY_MS;
1980
1981 /**
1982 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_TIMEOUT_MS}
1983 * instead
1984 */
1985 @Deprecated
1986 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS =
1987 Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS;
1988 }
1989
1990 /**
1991 * Secure system settings, containing system preferences that applications
1992 * can read but are not allowed to write. These are for preferences that
1993 * the user must explicitly modify through the system UI or specialized
1994 * APIs for those values, not modified directly by applications.
1995 */
1996 public static final class Secure extends NameValueTable {
1997 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_secure_version";
1998
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001999 // Populated lazily, guarded by class object:
2000 private static NameValueCache sNameValueCache = null;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002001
2002 /**
2003 * Look up a name in the database.
2004 * @param resolver to access the database with
2005 * @param name to look up in the table
2006 * @return the corresponding value, or null if not present
2007 */
2008 public synchronized static String getString(ContentResolver resolver, String name) {
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08002009 if (sNameValueCache == null) {
2010 sNameValueCache = new NameValueCache(SYS_PROP_SETTING_VERSION, CONTENT_URI,
2011 CALL_METHOD_GET_SECURE);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002012 }
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08002013 return sNameValueCache.getString(resolver, name);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002014 }
2015
2016 /**
2017 * Store a name/value pair into the database.
2018 * @param resolver to access the database with
2019 * @param name to store
2020 * @param value to associate with the name
2021 * @return true if the value was set, false on database errors
2022 */
2023 public static boolean putString(ContentResolver resolver,
2024 String name, String value) {
2025 return putString(resolver, CONTENT_URI, name, value);
2026 }
2027
2028 /**
2029 * Construct the content URI for a particular name/value pair,
2030 * useful for monitoring changes with a ContentObserver.
2031 * @param name to look up in the table
2032 * @return the corresponding content URI, or null if not present
2033 */
2034 public static Uri getUriFor(String name) {
2035 return getUriFor(CONTENT_URI, name);
2036 }
2037
2038 /**
2039 * Convenience function for retrieving a single secure settings value
2040 * as an integer. Note that internally setting values are always
2041 * stored as strings; this function converts the string to an integer
2042 * for you. The default value will be returned if the setting is
2043 * not defined or not an integer.
2044 *
2045 * @param cr The ContentResolver to access.
2046 * @param name The name of the setting to retrieve.
2047 * @param def Value to return if the setting is not defined.
2048 *
2049 * @return The setting's current value, or 'def' if it is not defined
2050 * or not a valid integer.
2051 */
2052 public static int getInt(ContentResolver cr, String name, int def) {
2053 String v = getString(cr, name);
2054 try {
2055 return v != null ? Integer.parseInt(v) : def;
2056 } catch (NumberFormatException e) {
2057 return def;
2058 }
2059 }
2060
2061 /**
2062 * Convenience function for retrieving a single secure settings value
2063 * as an integer. Note that internally setting values are always
2064 * stored as strings; this function converts the string to an integer
2065 * for you.
2066 * <p>
2067 * This version does not take a default value. If the setting has not
2068 * been set, or the string value is not a number,
2069 * it throws {@link SettingNotFoundException}.
2070 *
2071 * @param cr The ContentResolver to access.
2072 * @param name The name of the setting to retrieve.
2073 *
2074 * @throws SettingNotFoundException Thrown if a setting by the given
2075 * name can't be found or the setting value is not an integer.
2076 *
2077 * @return The setting's current value.
2078 */
2079 public static int getInt(ContentResolver cr, String name)
2080 throws SettingNotFoundException {
2081 String v = getString(cr, name);
2082 try {
2083 return Integer.parseInt(v);
2084 } catch (NumberFormatException e) {
2085 throw new SettingNotFoundException(name);
2086 }
2087 }
2088
2089 /**
2090 * Convenience function for updating a single settings value as an
2091 * integer. This will either create a new entry in the table if the
2092 * given name does not exist, or modify the value of the existing row
2093 * with that name. Note that internally setting values are always
2094 * stored as strings, so this function converts the given value to a
2095 * string before storing it.
2096 *
2097 * @param cr The ContentResolver to access.
2098 * @param name The name of the setting to modify.
2099 * @param value The new value for the setting.
2100 * @return true if the value was set, false on database errors
2101 */
2102 public static boolean putInt(ContentResolver cr, String name, int value) {
2103 return putString(cr, name, Integer.toString(value));
2104 }
2105
2106 /**
2107 * Convenience function for retrieving a single secure settings value
2108 * as a {@code long}. Note that internally setting values are always
2109 * stored as strings; this function converts the string to a {@code long}
2110 * for you. The default value will be returned if the setting is
2111 * not defined or not a {@code long}.
2112 *
2113 * @param cr The ContentResolver to access.
2114 * @param name The name of the setting to retrieve.
2115 * @param def Value to return if the setting is not defined.
2116 *
2117 * @return The setting's current value, or 'def' if it is not defined
2118 * or not a valid {@code long}.
2119 */
2120 public static long getLong(ContentResolver cr, String name, long def) {
2121 String valString = getString(cr, name);
2122 long value;
2123 try {
2124 value = valString != null ? Long.parseLong(valString) : def;
2125 } catch (NumberFormatException e) {
2126 value = def;
2127 }
2128 return value;
2129 }
2130
2131 /**
2132 * Convenience function for retrieving a single secure settings value
2133 * as a {@code long}. Note that internally setting values are always
2134 * stored as strings; this function converts the string to a {@code long}
2135 * for you.
2136 * <p>
2137 * This version does not take a default value. If the setting has not
2138 * been set, or the string value is not a number,
2139 * it throws {@link SettingNotFoundException}.
2140 *
2141 * @param cr The ContentResolver to access.
2142 * @param name The name of the setting to retrieve.
2143 *
2144 * @return The setting's current value.
2145 * @throws SettingNotFoundException Thrown if a setting by the given
2146 * name can't be found or the setting value is not an integer.
2147 */
2148 public static long getLong(ContentResolver cr, String name)
2149 throws SettingNotFoundException {
2150 String valString = getString(cr, name);
2151 try {
2152 return Long.parseLong(valString);
2153 } catch (NumberFormatException e) {
2154 throw new SettingNotFoundException(name);
2155 }
2156 }
2157
2158 /**
2159 * Convenience function for updating a secure settings value as a long
2160 * integer. This will either create a new entry in the table if the
2161 * given name does not exist, or modify the value of the existing row
2162 * with that name. Note that internally setting values are always
2163 * stored as strings, so this function converts the given value to a
2164 * string before storing it.
2165 *
2166 * @param cr The ContentResolver to access.
2167 * @param name The name of the setting to modify.
2168 * @param value The new value for the setting.
2169 * @return true if the value was set, false on database errors
2170 */
2171 public static boolean putLong(ContentResolver cr, String name, long value) {
2172 return putString(cr, name, Long.toString(value));
2173 }
2174
2175 /**
2176 * Convenience function for retrieving a single secure settings value
2177 * as a floating point number. Note that internally setting values are
2178 * always stored as strings; this function converts the string to an
2179 * float for you. The default value will be returned if the setting
2180 * is not defined or not a valid float.
2181 *
2182 * @param cr The ContentResolver to access.
2183 * @param name The name of the setting to retrieve.
2184 * @param def Value to return if the setting is not defined.
2185 *
2186 * @return The setting's current value, or 'def' if it is not defined
2187 * or not a valid float.
2188 */
2189 public static float getFloat(ContentResolver cr, String name, float def) {
2190 String v = getString(cr, name);
2191 try {
2192 return v != null ? Float.parseFloat(v) : def;
2193 } catch (NumberFormatException e) {
2194 return def;
2195 }
2196 }
2197
2198 /**
2199 * Convenience function for retrieving a single secure settings value
2200 * as a float. Note that internally setting values are always
2201 * stored as strings; this function converts the string to a float
2202 * for you.
2203 * <p>
2204 * This version does not take a default value. If the setting has not
2205 * been set, or the string value is not a number,
2206 * it throws {@link SettingNotFoundException}.
2207 *
2208 * @param cr The ContentResolver to access.
2209 * @param name The name of the setting to retrieve.
2210 *
2211 * @throws SettingNotFoundException Thrown if a setting by the given
2212 * name can't be found or the setting value is not a float.
2213 *
2214 * @return The setting's current value.
2215 */
2216 public static float getFloat(ContentResolver cr, String name)
2217 throws SettingNotFoundException {
2218 String v = getString(cr, name);
2219 try {
2220 return Float.parseFloat(v);
2221 } catch (NumberFormatException e) {
2222 throw new SettingNotFoundException(name);
2223 }
2224 }
2225
2226 /**
2227 * Convenience function for updating a single settings value as a
2228 * floating point number. This will either create a new entry in the
2229 * table if the given name does not exist, or modify the value of the
2230 * existing row with that name. Note that internally setting values
2231 * are always stored as strings, so this function converts the given
2232 * value to a string before storing it.
2233 *
2234 * @param cr The ContentResolver to access.
2235 * @param name The name of the setting to modify.
2236 * @param value The new value for the setting.
2237 * @return true if the value was set, false on database errors
2238 */
2239 public static boolean putFloat(ContentResolver cr, String name, float value) {
2240 return putString(cr, name, Float.toString(value));
2241 }
2242
2243 /**
2244 * The content:// style URL for this table
2245 */
2246 public static final Uri CONTENT_URI =
2247 Uri.parse("content://" + AUTHORITY + "/secure");
2248
2249 /**
2250 * Whether ADB is enabled.
2251 */
2252 public static final String ADB_ENABLED = "adb_enabled";
2253
2254 /**
2255 * Setting to allow mock locations and location provider status to be injected into the
2256 * LocationManager service for testing purposes during application development. These
2257 * locations and status values override actual location and status information generated
2258 * by network, gps, or other location providers.
2259 */
2260 public static final String ALLOW_MOCK_LOCATION = "mock_location";
2261
2262 /**
Doug Zongkerd8893db2010-01-26 12:29:44 -08002263 * A 64-bit number (as a hex string) that is randomly
2264 * generated on the device's first boot and should remain
2265 * constant for the lifetime of the device. (The value may
2266 * change if a factory reset is performed on the device.)
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002267 */
2268 public static final String ANDROID_ID = "android_id";
2269
2270 /**
2271 * Whether bluetooth is enabled/disabled
2272 * 0=disabled. 1=enabled.
2273 */
2274 public static final String BLUETOOTH_ON = "bluetooth_on";
2275
2276 /**
2277 * Get the key that retrieves a bluetooth headset's priority.
2278 * @hide
2279 */
2280 public static final String getBluetoothHeadsetPriorityKey(String address) {
2281 return ("bluetooth_headset_priority_" + address.toUpperCase());
2282 }
2283
2284 /**
2285 * Get the key that retrieves a bluetooth a2dp sink's priority.
2286 * @hide
2287 */
2288 public static final String getBluetoothA2dpSinkPriorityKey(String address) {
2289 return ("bluetooth_a2dp_sink_priority_" + address.toUpperCase());
2290 }
2291
2292 /**
2293 * Whether or not data roaming is enabled. (0 = false, 1 = true)
2294 */
2295 public static final String DATA_ROAMING = "data_roaming";
2296
2297 /**
2298 * Setting to record the input method used by default, holding the ID
2299 * of the desired method.
2300 */
2301 public static final String DEFAULT_INPUT_METHOD = "default_input_method";
2302
2303 /**
2304 * Whether the device has been provisioned (0 = false, 1 = true)
2305 */
2306 public static final String DEVICE_PROVISIONED = "device_provisioned";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002307
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002308 /**
2309 * List of input methods that are currently enabled. This is a string
2310 * containing the IDs of all enabled input methods, each ID separated
2311 * by ':'.
2312 */
2313 public static final String ENABLED_INPUT_METHODS = "enabled_input_methods";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002314
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002315 /**
Amith Yamasanie861ec12010-03-24 21:39:27 -07002316 * List of system input methods that are currently disabled. This is a string
2317 * containing the IDs of all disabled input methods, each ID separated
2318 * by ':'.
2319 * @hide
2320 */
2321 public static final String DISABLED_SYSTEM_INPUT_METHODS = "disabled_system_input_methods";
2322
2323 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002324 * Host name and port for a user-selected proxy.
2325 */
2326 public static final String HTTP_PROXY = "http_proxy";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002327
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002328 /**
2329 * Whether the package installer should allow installation of apps downloaded from
2330 * sources other than the Android Market (vending machine).
2331 *
2332 * 1 = allow installing from other sources
2333 * 0 = only allow installing from the Android Market
2334 */
2335 public static final String INSTALL_NON_MARKET_APPS = "install_non_market_apps";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002336
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002337 /**
2338 * Comma-separated list of location providers that activities may access.
2339 */
2340 public static final String LOCATION_PROVIDERS_ALLOWED = "location_providers_allowed";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002341
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002342 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08002343 * Whether autolock is enabled (0 = false, 1 = true)
2344 */
2345 public static final String LOCK_PATTERN_ENABLED = "lock_pattern_autolock";
2346
2347 /**
2348 * Whether lock pattern is visible as user enters (0 = false, 1 = true)
2349 */
2350 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
2351
2352 /**
2353 * Whether lock pattern will vibrate as user enters (0 = false, 1 = true)
2354 */
2355 public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
2356 "lock_pattern_tactile_feedback_enabled";
2357
2358 /**
Mike Lockwoodbcab8df2009-06-25 16:39:09 -04002359 * Whether assisted GPS should be enabled or not.
2360 * @hide
2361 */
2362 public static final String ASSISTED_GPS_ENABLED = "assisted_gps_enabled";
2363
2364 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002365 * The Logging ID (a unique 64-bit value) as a hex string.
2366 * Used as a pseudonymous identifier for logging.
2367 * @deprecated This identifier is poorly initialized and has
2368 * many collisions. It should not be used.
2369 */
2370 @Deprecated
2371 public static final String LOGGING_ID = "logging_id";
2372
2373 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002374 * User preference for which network(s) should be used. Only the
2375 * connectivity service should touch this.
2376 */
2377 public static final String NETWORK_PREFERENCE = "network_preference";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002378
2379 /**
Robert Greenwalt2a091d72010-02-11 18:18:40 -08002380 * Used to disable Tethering on a device - defaults to true
2381 * @hide
2382 */
2383 public static final String TETHER_SUPPORTED = "tether_supported";
2384
2385 /**
Robert Greenwalt77b32dd2010-06-03 18:57:26 -07002386 * Used to require DUN APN on the device or not - defaults to a build config value
2387 * which defaults to false
2388 * @hide
2389 */
2390 public static final String TETHER_DUN_REQUIRED = "tether_dun_required";
2391
2392 /**
2393 * Used to hold a gservices-provisioned apn value for DUN. If set, or the
2394 * corresponding build config values are set it will override the APN DB
2395 * values.
2396 * Consists of a comma seperated list of strings:
2397 * "name,apn,proxy,port,username,password,server,mmsc,mmsproxy,mmsport,mcc,mnc,auth,type"
2398 * note that empty fields can be ommitted: "name,apn,,,,,,,,,310,260,,DUN"
2399 * @hide
2400 */
2401 public static final String TETHER_DUN_APN = "tether_dun_apn";
2402
2403 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002404 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002405 */
2406 public static final String PARENTAL_CONTROL_ENABLED = "parental_control_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002407
2408 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002409 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002410 */
2411 public static final String PARENTAL_CONTROL_LAST_UPDATE = "parental_control_last_update";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002412
2413 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08002414 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002415 */
2416 public static final String PARENTAL_CONTROL_REDIRECT_URL = "parental_control_redirect_url";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002417
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002418 /**
2419 * Settings classname to launch when Settings is clicked from All
2420 * Applications. Needed because of user testing between the old
2421 * and new Settings apps.
2422 */
2423 // TODO: 881807
2424 public static final String SETTINGS_CLASSNAME = "settings_classname";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002425
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002426 /**
2427 * USB Mass Storage Enabled
2428 */
2429 public static final String USB_MASS_STORAGE_ENABLED = "usb_mass_storage_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002430
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002431 /**
2432 * If this setting is set (to anything), then all references
2433 * to Gmail on the device must change to Google Mail.
2434 */
2435 public static final String USE_GOOGLE_MAIL = "use_google_mail";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002436
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002437 /**
svetoslavganov75986cf2009-05-14 22:28:01 -07002438 * If accessibility is enabled.
2439 */
2440 public static final String ACCESSIBILITY_ENABLED = "accessibility_enabled";
2441
2442 /**
2443 * List of the enabled accessibility providers.
2444 */
2445 public static final String ENABLED_ACCESSIBILITY_SERVICES =
2446 "enabled_accessibility_services";
2447
2448 /**
Jean-Michel Trivif62ba452009-06-04 14:55:24 -07002449 * Setting to always use the default text-to-speech settings regardless
2450 * of the application settings.
2451 * 1 = override application settings,
2452 * 0 = use application settings (if specified).
2453 */
2454 public static final String TTS_USE_DEFAULTS = "tts_use_defaults";
2455
2456 /**
2457 * Default text-to-speech engine speech rate. 100 = 1x
2458 */
2459 public static final String TTS_DEFAULT_RATE = "tts_default_rate";
2460
2461 /**
2462 * Default text-to-speech engine pitch. 100 = 1x
2463 */
2464 public static final String TTS_DEFAULT_PITCH = "tts_default_pitch";
2465
2466 /**
2467 * Default text-to-speech engine.
2468 */
2469 public static final String TTS_DEFAULT_SYNTH = "tts_default_synth";
2470
2471 /**
Jean-Michel Trivif4782672009-06-09 16:22:48 -07002472 * Default text-to-speech language.
2473 */
2474 public static final String TTS_DEFAULT_LANG = "tts_default_lang";
2475
2476 /**
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07002477 * Default text-to-speech country.
2478 */
2479 public static final String TTS_DEFAULT_COUNTRY = "tts_default_country";
2480
2481 /**
2482 * Default text-to-speech locale variant.
2483 */
2484 public static final String TTS_DEFAULT_VARIANT = "tts_default_variant";
2485
2486 /**
Charles Chenceffa152010-03-16 21:18:10 -07002487 * Space delimited list of plugin packages that are enabled.
2488 */
2489 public static final String TTS_ENABLED_PLUGINS = "tts_enabled_plugins";
2490
2491 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002492 * Whether to notify the user of open networks.
2493 * <p>
2494 * If not connected and the scan results have an open network, we will
2495 * put this notification up. If we attempt to connect to a network or
2496 * the open network(s) disappear, we remove the notification. When we
2497 * show the notification, we will not show it again for
2498 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} time.
2499 */
2500 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
2501 "wifi_networks_available_notification_on";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002502
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002503 /**
2504 * Delay (in seconds) before repeating the Wi-Fi networks available notification.
2505 * Connecting to a network will reset the timer.
2506 */
2507 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
2508 "wifi_networks_available_repeat_delay";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002509
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002510 /**
2511 * The number of radio channels that are allowed in the local
2512 * 802.11 regulatory domain.
2513 * @hide
2514 */
2515 public static final String WIFI_NUM_ALLOWED_CHANNELS = "wifi_num_allowed_channels";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002516
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002517 /**
2518 * When the number of open networks exceeds this number, the
2519 * least-recently-used excess networks will be removed.
2520 */
2521 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = "wifi_num_open_networks_kept";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002522
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002523 /**
2524 * Whether the Wi-Fi should be on. Only the Wi-Fi service should touch this.
2525 */
2526 public static final String WIFI_ON = "wifi_on";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002527
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002528 /**
Irfan Sheriffa3bd4092010-03-24 17:58:59 -07002529 * Used to save the Wifi_ON state prior to tethering.
2530 * This state will be checked to restore Wifi after
2531 * the user turns off tethering.
Irfan Sheriff5321aef2010-02-12 12:35:59 -08002532 *
2533 * @hide
2534 */
Irfan Sheriffa3bd4092010-03-24 17:58:59 -07002535 public static final String WIFI_SAVED_STATE = "wifi_saved_state";
Irfan Sheriff5321aef2010-02-12 12:35:59 -08002536
2537 /**
Irfan Sheriff9ab518ad2010-03-12 15:48:17 -08002538 * AP SSID
2539 *
2540 * @hide
2541 */
2542 public static final String WIFI_AP_SSID = "wifi_ap_ssid";
2543
2544 /**
2545 * AP security
2546 *
2547 * @hide
2548 */
2549 public static final String WIFI_AP_SECURITY = "wifi_ap_security";
2550
2551 /**
2552 * AP passphrase
2553 *
2554 * @hide
2555 */
2556 public static final String WIFI_AP_PASSWD = "wifi_ap_passwd";
2557
2558 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002559 * The acceptable packet loss percentage (range 0 - 100) before trying
2560 * another AP on the same network.
2561 */
2562 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
2563 "wifi_watchdog_acceptable_packet_loss_percentage";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002564
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002565 /**
2566 * The number of access points required for a network in order for the
2567 * watchdog to monitor it.
2568 */
2569 public static final String WIFI_WATCHDOG_AP_COUNT = "wifi_watchdog_ap_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002570
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002571 /**
2572 * The delay between background checks.
2573 */
2574 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
2575 "wifi_watchdog_background_check_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002576
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002577 /**
2578 * Whether the Wi-Fi watchdog is enabled for background checking even
2579 * after it thinks the user has connected to a good access point.
2580 */
2581 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
2582 "wifi_watchdog_background_check_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002583
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002584 /**
2585 * The timeout for a background ping
2586 */
2587 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
2588 "wifi_watchdog_background_check_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002589
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002590 /**
2591 * The number of initial pings to perform that *may* be ignored if they
2592 * fail. Again, if these fail, they will *not* be used in packet loss
2593 * calculation. For example, one network always seemed to time out for
2594 * the first couple pings, so this is set to 3 by default.
2595 */
2596 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
2597 "wifi_watchdog_initial_ignored_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002598
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002599 /**
2600 * The maximum number of access points (per network) to attempt to test.
2601 * If this number is reached, the watchdog will no longer monitor the
2602 * initial connection state for the network. This is a safeguard for
2603 * networks containing multiple APs whose DNS does not respond to pings.
2604 */
2605 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = "wifi_watchdog_max_ap_checks";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002606
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002607 /**
2608 * Whether the Wi-Fi watchdog is enabled.
2609 */
2610 public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
2611
2612 /**
2613 * 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 -08002614 */
2615 public static final String WIFI_WATCHDOG_WATCH_LIST = "wifi_watchdog_watch_list";
2616
2617 /**
2618 * The number of pings to test if an access point is a good connection.
2619 */
2620 public static final String WIFI_WATCHDOG_PING_COUNT = "wifi_watchdog_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002621
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002622 /**
2623 * The delay between pings.
2624 */
2625 public static final String WIFI_WATCHDOG_PING_DELAY_MS = "wifi_watchdog_ping_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002626
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002627 /**
2628 * The timeout per ping.
2629 */
2630 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS = "wifi_watchdog_ping_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002631
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002632 /**
2633 * The maximum number of times we will retry a connection to an access
2634 * point for which we have failed in acquiring an IP address from DHCP.
2635 * 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 -08002636 */
2637 public static final String WIFI_MAX_DHCP_RETRY_COUNT = "wifi_max_dhcp_retry_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002638
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002639 /**
2640 * Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile
2641 * data connectivity to be established after a disconnect from Wi-Fi.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002642 */
2643 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
2644 "wifi_mobile_data_transition_wakelock_timeout_ms";
2645
2646 /**
2647 * Whether background data usage is allowed by the user. See
2648 * ConnectivityManager for more info.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002649 */
2650 public static final String BACKGROUND_DATA = "background_data";
Wink Saville04e71b32009-04-02 11:00:54 -07002651
2652 /**
Bjorn Bringert98bfa392010-03-24 10:59:48 +00002653 * Origins for which browsers should allow geolocation by default.
2654 * The value is a space-separated list of origins.
2655 */
2656 public static final String ALLOWED_GEOLOCATION_ORIGINS
2657 = "allowed_geolocation_origins";
2658
2659 /**
Robert Greenwaltc03fa502010-02-23 18:58:05 -08002660 * Whether mobile data connections are allowed by the user. See
2661 * ConnectivityManager for more info.
2662 * @hide
2663 */
2664 public static final String MOBILE_DATA = "mobile_data";
2665
2666 /**
Wink Saville04e71b32009-04-02 11:00:54 -07002667 * The CDMA roaming mode 0 = Home Networks, CDMA default
2668 * 1 = Roaming on Affiliated networks
2669 * 2 = Roaming on any networks
2670 * @hide
2671 */
2672 public static final String CDMA_ROAMING_MODE = "roaming_settings";
2673
2674 /**
2675 * The CDMA subscription mode 0 = RUIM/SIM (default)
2676 * 1 = NV
2677 * @hide
2678 */
2679 public static final String CDMA_SUBSCRIPTION_MODE = "subscription_mode";
2680
2681 /**
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002682 * The preferred network mode 7 = Global
2683 * 6 = EvDo only
2684 * 5 = CDMA w/o EvDo
2685 * 4 = CDMA / EvDo auto
2686 * 3 = GSM / WCDMA auto
2687 * 2 = WCDMA only
2688 * 1 = GSM only
2689 * 0 = GSM / WCDMA preferred
Wink Saville04e71b32009-04-02 11:00:54 -07002690 * @hide
2691 */
2692 public static final String PREFERRED_NETWORK_MODE =
2693 "preferred_network_mode";
2694
2695 /**
Wink Savillee9b06d72009-05-18 21:47:50 -07002696 * The preferred TTY mode 0 = TTy Off, CDMA default
2697 * 1 = TTY Full
2698 * 2 = TTY HCO
2699 * 3 = TTY VCO
2700 * @hide
2701 */
2702 public static final String PREFERRED_TTY_MODE =
2703 "preferred_tty_mode";
2704
2705
2706 /**
Wink Saville04e71b32009-04-02 11:00:54 -07002707 * CDMA Cell Broadcast SMS
2708 * 0 = CDMA Cell Broadcast SMS disabled
2709 * 1 = CDMA Cell Broadcast SMS enabled
2710 * @hide
2711 */
2712 public static final String CDMA_CELL_BROADCAST_SMS =
2713 "cdma_cell_broadcast_sms";
2714
2715 /**
2716 * The cdma subscription 0 = Subscription from RUIM, when available
2717 * 1 = Subscription from NV
2718 * @hide
2719 */
2720 public static final String PREFERRED_CDMA_SUBSCRIPTION =
2721 "preferred_cdma_subscription";
2722
2723 /**
2724 * Whether the enhanced voice privacy mode is enabled.
2725 * 0 = normal voice privacy
2726 * 1 = enhanced voice privacy
2727 * @hide
2728 */
2729 public static final String ENHANCED_VOICE_PRIVACY_ENABLED = "enhanced_voice_privacy_enabled";
2730
2731 /**
2732 * Whether the TTY mode mode is enabled.
2733 * 0 = disabled
2734 * 1 = enabled
2735 * @hide
2736 */
2737 public static final String TTY_MODE_ENABLED = "tty_mode_enabled";
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07002738
2739 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07002740 * Controls whether settings backup is enabled.
Dianne Hackborncf098292009-07-01 19:55:20 -07002741 * Type: int ( 0 = disabled, 1 = enabled )
2742 * @hide
2743 */
2744 public static final String BACKUP_ENABLED = "backup_enabled";
2745
2746 /**
Christopher Tatecce9da52010-02-03 15:11:15 -08002747 * Controls whether application data is automatically restored from backup
2748 * at install time.
2749 * Type: int ( 0 = disabled, 1 = enabled )
2750 * @hide
2751 */
2752 public static final String BACKUP_AUTO_RESTORE = "backup_auto_restore";
2753
2754 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07002755 * Indicates whether settings backup has been fully provisioned.
2756 * Type: int ( 0 = unprovisioned, 1 = fully provisioned )
2757 * @hide
2758 */
2759 public static final String BACKUP_PROVISIONED = "backup_provisioned";
2760
2761 /**
Dianne Hackborncf098292009-07-01 19:55:20 -07002762 * Component of the transport to use for backup/restore.
2763 * @hide
2764 */
2765 public static final String BACKUP_TRANSPORT = "backup_transport";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07002766
Dianne Hackbornd7cd29d2009-07-01 11:22:45 -07002767 /**
2768 * Version for which the setup wizard was last shown. Bumped for
2769 * each release when there is new setup information to show.
2770 * @hide
2771 */
2772 public static final String LAST_SETUP_SHOWN = "last_setup_shown";
Dianne Hackborncf098292009-07-01 19:55:20 -07002773
2774 /**
Doug Zongkerf6888892010-01-06 16:38:14 -08002775 * How frequently (in seconds) to check the memory status of the
2776 * device.
2777 * @hide
2778 */
2779 public static final String MEMCHECK_INTERVAL = "memcheck_interval";
2780
2781 /**
2782 * Max frequency (in seconds) to log memory check stats, in realtime
2783 * seconds. This allows for throttling of logs when the device is
2784 * running for large amounts of time.
2785 * @hide
2786 */
2787 public static final String MEMCHECK_LOG_REALTIME_INTERVAL =
2788 "memcheck_log_realtime_interval";
2789
2790 /**
2791 * Boolean indicating whether rebooting due to system memory checks
2792 * is enabled.
2793 * @hide
2794 */
2795 public static final String MEMCHECK_SYSTEM_ENABLED = "memcheck_system_enabled";
2796
2797 /**
2798 * How many bytes the system process must be below to avoid scheduling
2799 * a soft reboot. This reboot will happen when it is next determined
2800 * to be a good time.
2801 * @hide
2802 */
2803 public static final String MEMCHECK_SYSTEM_SOFT_THRESHOLD = "memcheck_system_soft";
2804
2805 /**
2806 * How many bytes the system process must be below to avoid scheduling
2807 * a hard reboot. This reboot will happen immediately.
2808 * @hide
2809 */
2810 public static final String MEMCHECK_SYSTEM_HARD_THRESHOLD = "memcheck_system_hard";
2811
2812 /**
2813 * How many bytes the phone process must be below to avoid scheduling
2814 * a soft restart. This restart will happen when it is next determined
2815 * to be a good time.
2816 * @hide
2817 */
2818 public static final String MEMCHECK_PHONE_SOFT_THRESHOLD = "memcheck_phone_soft";
2819
2820 /**
2821 * How many bytes the phone process must be below to avoid scheduling
2822 * a hard restart. This restart will happen immediately.
2823 * @hide
2824 */
2825 public static final String MEMCHECK_PHONE_HARD_THRESHOLD = "memcheck_phone_hard";
2826
2827 /**
2828 * Boolean indicating whether restarting the phone process due to
2829 * memory checks is enabled.
2830 * @hide
2831 */
2832 public static final String MEMCHECK_PHONE_ENABLED = "memcheck_phone_enabled";
2833
2834 /**
2835 * First time during the day it is okay to kill processes
2836 * or reboot the device due to low memory situations. This number is
2837 * in seconds since midnight.
2838 * @hide
2839 */
2840 public static final String MEMCHECK_EXEC_START_TIME = "memcheck_exec_start_time";
2841
2842 /**
2843 * Last time during the day it is okay to kill processes
2844 * or reboot the device due to low memory situations. This number is
2845 * in seconds since midnight.
2846 * @hide
2847 */
2848 public static final String MEMCHECK_EXEC_END_TIME = "memcheck_exec_end_time";
2849
2850 /**
2851 * How long the screen must have been off in order to kill processes
2852 * or reboot. This number is in seconds. A value of -1 means to
2853 * entirely disregard whether the screen is on.
2854 * @hide
2855 */
2856 public static final String MEMCHECK_MIN_SCREEN_OFF = "memcheck_min_screen_off";
2857
2858 /**
2859 * How much time there must be until the next alarm in order to kill processes
2860 * or reboot. This number is in seconds. Note: this value must be
2861 * smaller than {@link #MEMCHECK_RECHECK_INTERVAL} or else it will
2862 * always see an alarm scheduled within its time.
2863 * @hide
2864 */
2865 public static final String MEMCHECK_MIN_ALARM = "memcheck_min_alarm";
2866
2867 /**
2868 * How frequently to check whether it is a good time to restart things,
2869 * if the device is in a bad state. This number is in seconds. Note:
2870 * this value must be larger than {@link #MEMCHECK_MIN_ALARM} or else
2871 * the alarm to schedule the recheck will always appear within the
2872 * minimum "do not execute now" time.
2873 * @hide
2874 */
2875 public static final String MEMCHECK_RECHECK_INTERVAL = "memcheck_recheck_interval";
2876
2877 /**
2878 * How frequently (in DAYS) to reboot the device. If 0, no reboots
2879 * will occur.
2880 * @hide
2881 */
2882 public static final String REBOOT_INTERVAL = "reboot_interval";
2883
2884 /**
2885 * First time during the day it is okay to force a reboot of the
2886 * device (if REBOOT_INTERVAL is set). This number is
2887 * in seconds since midnight.
2888 * @hide
2889 */
2890 public static final String REBOOT_START_TIME = "reboot_start_time";
2891
2892 /**
2893 * The window of time (in seconds) after each REBOOT_INTERVAL in which
2894 * a reboot can be executed. If 0, a reboot will always be executed at
2895 * exactly the given time. Otherwise, it will only be executed if
2896 * the device is idle within the window.
2897 * @hide
2898 */
2899 public static final String REBOOT_WINDOW = "reboot_window";
2900
2901 /**
Doug Zongker43866e02010-01-07 12:09:54 -08002902 * Threshold values for the duration and level of a discharge cycle, under
2903 * which we log discharge cycle info.
2904 * @hide
2905 */
2906 public static final String BATTERY_DISCHARGE_DURATION_THRESHOLD =
2907 "battery_discharge_duration_threshold";
2908 /** @hide */
2909 public static final String BATTERY_DISCHARGE_THRESHOLD = "battery_discharge_threshold";
2910
2911 /**
2912 * Flag for allowing ActivityManagerService to send ACTION_APP_ERROR intents
2913 * on application crashes and ANRs. If this is disabled, the crash/ANR dialog
2914 * will never display the "Report" button.
2915 * Type: int ( 0 = disallow, 1 = allow )
2916 * @hide
2917 */
2918 public static final String SEND_ACTION_APP_ERROR = "send_action_app_error";
2919
2920 /**
2921 * Nonzero causes Log.wtf() to crash.
2922 * @hide
2923 */
2924 public static final String WTF_IS_FATAL = "wtf_is_fatal";
2925
2926 /**
2927 * Maximum age of entries kept by {@link android.os.IDropBox}.
2928 * @hide
2929 */
2930 public static final String DROPBOX_AGE_SECONDS =
2931 "dropbox_age_seconds";
2932 /**
Dan Egnor3a8b0c12010-03-24 17:48:20 -07002933 * Maximum number of entry files which {@link android.os.IDropBox} will keep around.
2934 * @hide
2935 */
2936 public static final String DROPBOX_MAX_FILES =
2937 "dropbox_max_files";
2938 /**
Doug Zongker43866e02010-01-07 12:09:54 -08002939 * Maximum amount of disk space used by {@link android.os.IDropBox} no matter what.
2940 * @hide
2941 */
2942 public static final String DROPBOX_QUOTA_KB =
2943 "dropbox_quota_kb";
2944 /**
2945 * Percent of free disk (excluding reserve) which {@link android.os.IDropBox} will use.
2946 * @hide
2947 */
2948 public static final String DROPBOX_QUOTA_PERCENT =
2949 "dropbox_quota_percent";
2950 /**
2951 * Percent of total disk which {@link android.os.IDropBox} will never dip into.
2952 * @hide
2953 */
2954 public static final String DROPBOX_RESERVE_PERCENT =
2955 "dropbox_reserve_percent";
2956 /**
2957 * Prefix for per-tag dropbox disable/enable settings.
2958 * @hide
2959 */
2960 public static final String DROPBOX_TAG_PREFIX =
2961 "dropbox:";
Dan Egnora455d192010-03-12 08:52:28 -08002962 /**
2963 * Lines of logcat to include with system crash/ANR/etc. reports,
2964 * as a prefix of the dropbox tag of the report type.
2965 * For example, "logcat_for_system_server_anr" controls the lines
2966 * of logcat captured with system server ANR reports. 0 to disable.
2967 * @hide
2968 */
2969 public static final String ERROR_LOGCAT_PREFIX =
2970 "logcat_for_";
Doug Zongker43866e02010-01-07 12:09:54 -08002971
2972
2973 /**
2974 * Screen timeout in milliseconds corresponding to the
2975 * PowerManager's POKE_LOCK_SHORT_TIMEOUT flag (i.e. the fastest
2976 * possible screen timeout behavior.)
2977 * @hide
2978 */
2979 public static final String SHORT_KEYLIGHT_DELAY_MS =
2980 "short_keylight_delay_ms";
2981
2982 /**
2983 * The interval in minutes after which the amount of free storage left on the
2984 * device is logged to the event log
2985 * @hide
2986 */
2987 public static final String SYS_FREE_STORAGE_LOG_INTERVAL =
2988 "sys_free_storage_log_interval";
2989
2990 /**
2991 * Threshold for the amount of change in disk free space required to report the amount of
2992 * free space. Used to prevent spamming the logs when the disk free space isn't changing
2993 * frequently.
2994 * @hide
2995 */
2996 public static final String DISK_FREE_CHANGE_REPORTING_THRESHOLD =
2997 "disk_free_change_reporting_threshold";
2998
2999
3000 /**
3001 * Minimum percentage of free storage on the device that is used to determine if
3002 * the device is running low on storage.
3003 * Say this value is set to 10, the device is considered running low on storage
3004 * if 90% or more of the device storage is filled up.
3005 * @hide
3006 */
3007 public static final String SYS_STORAGE_THRESHOLD_PERCENTAGE =
3008 "sys_storage_threshold_percentage";
3009
3010 /**
3011 * The interval in milliseconds after which Wi-Fi is considered idle.
3012 * When idle, it is possible for the device to be switched from Wi-Fi to
3013 * the mobile data network.
3014 * @hide
3015 */
3016 public static final String WIFI_IDLE_MS = "wifi_idle_ms";
3017
3018 /**
Doug Zongkeredc51892010-01-07 13:51:16 -08003019 * The interval in milliseconds at which to check packet counts on the
3020 * mobile data interface when screen is on, to detect possible data
3021 * connection problems.
3022 * @hide
3023 */
3024 public static final String PDP_WATCHDOG_POLL_INTERVAL_MS =
3025 "pdp_watchdog_poll_interval_ms";
3026
3027 /**
3028 * The interval in milliseconds at which to check packet counts on the
3029 * mobile data interface when screen is off, to detect possible data
3030 * connection problems.
3031 * @hide
3032 */
3033 public static final String PDP_WATCHDOG_LONG_POLL_INTERVAL_MS =
3034 "pdp_watchdog_long_poll_interval_ms";
3035
3036 /**
3037 * The interval in milliseconds at which to check packet counts on the
3038 * mobile data interface after {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT}
3039 * outgoing packets has been reached without incoming packets.
3040 * @hide
3041 */
3042 public static final String PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS =
3043 "pdp_watchdog_error_poll_interval_ms";
3044
3045 /**
3046 * The number of outgoing packets sent without seeing an incoming packet
3047 * that triggers a countdown (of {@link #PDP_WATCHDOG_ERROR_POLL_COUNT}
3048 * device is logged to the event log
3049 * @hide
3050 */
3051 public static final String PDP_WATCHDOG_TRIGGER_PACKET_COUNT =
3052 "pdp_watchdog_trigger_packet_count";
3053
3054 /**
3055 * The number of polls to perform (at {@link #PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS})
3056 * after hitting {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT} before
3057 * attempting data connection recovery.
3058 * @hide
3059 */
3060 public static final String PDP_WATCHDOG_ERROR_POLL_COUNT =
3061 "pdp_watchdog_error_poll_count";
3062
3063 /**
3064 * The number of failed PDP reset attempts before moving to something more
3065 * drastic: re-registering to the network.
3066 * @hide
3067 */
3068 public static final String PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT =
3069 "pdp_watchdog_max_pdp_reset_fail_count";
3070
3071 /**
3072 * Address to ping as a last sanity check before attempting any recovery.
3073 * Unset or set to "0.0.0.0" to skip this check.
3074 * @hide
3075 */
3076 public static final String PDP_WATCHDOG_PING_ADDRESS = "pdp_watchdog_ping_address";
3077
3078 /**
3079 * The "-w deadline" parameter for the ping, ie, the max time in
3080 * seconds to spend pinging.
3081 * @hide
3082 */
3083 public static final String PDP_WATCHDOG_PING_DEADLINE = "pdp_watchdog_ping_deadline";
3084
3085 /**
3086 * The interval in milliseconds at which to check gprs registration
3087 * after the first registration mismatch of gprs and voice service,
3088 * to detect possible data network registration problems.
3089 *
3090 * @hide
3091 */
3092 public static final String GPRS_REGISTER_CHECK_PERIOD_MS =
3093 "gprs_register_check_period_ms";
3094
3095 /**
3096 * The length of time in milli-seconds that automatic small adjustments to
3097 * SystemClock are ignored if NITZ_UPDATE_DIFF is not exceeded.
3098 * @hide
3099 */
3100 public static final String NITZ_UPDATE_SPACING = "nitz_update_spacing";
3101
3102 /**
3103 * If the NITZ_UPDATE_DIFF time is exceeded then an automatic adjustment
3104 * to SystemClock will be allowed even if NITZ_UPDATE_SPACING has not been
3105 * exceeded.
3106 * @hide
3107 */
3108 public static final String NITZ_UPDATE_DIFF = "nitz_update_diff";
3109
3110 /**
3111 * The maximum reconnect delay for short network outages or when the network is suspended
3112 * due to phone use.
3113 * @hide
3114 */
3115 public static final String SYNC_MAX_RETRY_DELAY_IN_SECONDS =
3116 "sync_max_retry_delay_in_seconds";
3117
3118 /**
3119 * The interval in milliseconds at which to check the number of SMS sent
3120 * out without asking for use permit, to limit the un-authorized SMS
3121 * usage.
3122 * @hide
3123 */
3124 public static final String SMS_OUTGOING_CHECK_INTERVAL_MS =
3125 "sms_outgoing_check_interval_ms";
3126
3127 /**
3128 * The number of outgoing SMS sent without asking for user permit
3129 * (of {@link #SMS_OUTGOING_CHECK_INTERVAL_MS}
3130 * @hide
3131 */
3132 public static final String SMS_OUTGOING_CHECK_MAX_COUNT =
3133 "sms_outgoing_check_max_count";
3134
3135 /**
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003136 * The number of promoted sources in GlobalSearch.
3137 * @hide
3138 */
3139 public static final String SEARCH_NUM_PROMOTED_SOURCES = "search_num_promoted_sources";
3140 /**
3141 * The maximum number of suggestions returned by GlobalSearch.
3142 * @hide
3143 */
3144 public static final String SEARCH_MAX_RESULTS_TO_DISPLAY = "search_max_results_to_display";
3145 /**
3146 * The number of suggestions GlobalSearch will ask each non-web search source for.
3147 * @hide
3148 */
3149 public static final String SEARCH_MAX_RESULTS_PER_SOURCE = "search_max_results_per_source";
3150 /**
3151 * The number of suggestions the GlobalSearch will ask the web search source for.
3152 * @hide
3153 */
3154 public static final String SEARCH_WEB_RESULTS_OVERRIDE_LIMIT =
3155 "search_web_results_override_limit";
3156 /**
3157 * The number of milliseconds that GlobalSearch will wait for suggestions from
3158 * promoted sources before continuing with all other sources.
3159 * @hide
3160 */
3161 public static final String SEARCH_PROMOTED_SOURCE_DEADLINE_MILLIS =
3162 "search_promoted_source_deadline_millis";
3163 /**
3164 * The number of milliseconds before GlobalSearch aborts search suggesiton queries.
3165 * @hide
3166 */
3167 public static final String SEARCH_SOURCE_TIMEOUT_MILLIS = "search_source_timeout_millis";
3168 /**
3169 * The maximum number of milliseconds that GlobalSearch shows the previous results
3170 * after receiving a new query.
3171 * @hide
3172 */
3173 public static final String SEARCH_PREFILL_MILLIS = "search_prefill_millis";
3174 /**
3175 * The maximum age of log data used for shortcuts in GlobalSearch.
3176 * @hide
3177 */
3178 public static final String SEARCH_MAX_STAT_AGE_MILLIS = "search_max_stat_age_millis";
3179 /**
3180 * The maximum age of log data used for source ranking in GlobalSearch.
3181 * @hide
3182 */
3183 public static final String SEARCH_MAX_SOURCE_EVENT_AGE_MILLIS =
3184 "search_max_source_event_age_millis";
3185 /**
3186 * The minimum number of impressions needed to rank a source in GlobalSearch.
3187 * @hide
3188 */
3189 public static final String SEARCH_MIN_IMPRESSIONS_FOR_SOURCE_RANKING =
3190 "search_min_impressions_for_source_ranking";
3191 /**
3192 * The minimum number of clicks needed to rank a source in GlobalSearch.
3193 * @hide
3194 */
3195 public static final String SEARCH_MIN_CLICKS_FOR_SOURCE_RANKING =
3196 "search_min_clicks_for_source_ranking";
3197 /**
3198 * The maximum number of shortcuts shown by GlobalSearch.
3199 * @hide
3200 */
3201 public static final String SEARCH_MAX_SHORTCUTS_RETURNED = "search_max_shortcuts_returned";
3202 /**
3203 * The size of the core thread pool for suggestion queries in GlobalSearch.
3204 * @hide
3205 */
3206 public static final String SEARCH_QUERY_THREAD_CORE_POOL_SIZE =
3207 "search_query_thread_core_pool_size";
3208 /**
3209 * The maximum size of the thread pool for suggestion queries in GlobalSearch.
3210 * @hide
3211 */
3212 public static final String SEARCH_QUERY_THREAD_MAX_POOL_SIZE =
3213 "search_query_thread_max_pool_size";
3214 /**
3215 * The size of the core thread pool for shortcut refreshing in GlobalSearch.
3216 * @hide
3217 */
3218 public static final String SEARCH_SHORTCUT_REFRESH_CORE_POOL_SIZE =
3219 "search_shortcut_refresh_core_pool_size";
3220 /**
3221 * The maximum size of the thread pool for shortcut refreshing in GlobalSearch.
3222 * @hide
3223 */
3224 public static final String SEARCH_SHORTCUT_REFRESH_MAX_POOL_SIZE =
3225 "search_shortcut_refresh_max_pool_size";
3226 /**
3227 * The maximun time that excess threads in the GlobalSeach thread pools will
3228 * wait before terminating.
3229 * @hide
3230 */
3231 public static final String SEARCH_THREAD_KEEPALIVE_SECONDS =
3232 "search_thread_keepalive_seconds";
3233 /**
3234 * The maximum number of concurrent suggestion queries to each source.
3235 * @hide
3236 */
3237 public static final String SEARCH_PER_SOURCE_CONCURRENT_QUERY_LIMIT =
3238 "search_per_source_concurrent_query_limit";
3239
San Mehat87734d32010-01-08 12:53:06 -08003240 /**
3241 * Whether or not alert sounds are played on MountService events. (0 = false, 1 = true)
3242 * @hide
3243 */
3244 public static final String MOUNT_PLAY_NOTIFICATION_SND = "mount_play_not_snd";
3245
3246 /**
3247 * Whether or not UMS auto-starts on UMS host detection. (0 = false, 1 = true)
3248 * @hide
3249 */
3250 public static final String MOUNT_UMS_AUTOSTART = "mount_ums_autostart";
3251
3252 /**
3253 * Whether or not a notification is displayed on UMS host detection. (0 = false, 1 = true)
3254 * @hide
3255 */
3256 public static final String MOUNT_UMS_PROMPT = "mount_ums_prompt";
3257
3258 /**
3259 * Whether or not a notification is displayed while UMS is enabled. (0 = false, 1 = true)
3260 * @hide
3261 */
3262 public static final String MOUNT_UMS_NOTIFY_ENABLED = "mount_ums_notify_enabled";
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003263
Dan Egnor42471dd2010-01-07 17:25:22 -08003264 /**
3265 * If nonzero, ANRs in invisible background processes bring up a dialog.
3266 * Otherwise, the process will be silently killed.
3267 * @hide
3268 */
3269 public static final String ANR_SHOW_BACKGROUND = "anr_show_background";
Erikeebc8e22010-02-18 13:27:19 -08003270
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08003271 /**
3272 * The {@link ComponentName} string of the service to be used as the voice recognition
3273 * service.
Erikeebc8e22010-02-18 13:27:19 -08003274 *
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08003275 * @hide
3276 */
3277 public static final String VOICE_RECOGNITION_SERVICE = "voice_recognition_service";
Dan Egnor42471dd2010-01-07 17:25:22 -08003278
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08003279 /**
David Brown458e8062010-03-08 21:52:11 -08003280 * What happens when the user presses the Power button while in-call
3281 * and the screen is on.<br/>
3282 * <b>Values:</b><br/>
3283 * 1 - The Power button turns off the screen and locks the device. (Default behavior)<br/>
3284 * 2 - The Power button hangs up the current call.<br/>
3285 *
3286 * @hide
3287 */
3288 public static final String INCALL_POWER_BUTTON_BEHAVIOR = "incall_power_button_behavior";
3289
3290 /**
3291 * INCALL_POWER_BUTTON_BEHAVIOR value for "turn off screen".
3292 * @hide
3293 */
3294 public static final int INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF = 0x1;
3295
3296 /**
3297 * INCALL_POWER_BUTTON_BEHAVIOR value for "hang up".
3298 * @hide
3299 */
3300 public static final int INCALL_POWER_BUTTON_BEHAVIOR_HANGUP = 0x2;
3301
3302 /**
3303 * INCALL_POWER_BUTTON_BEHAVIOR default value.
3304 * @hide
3305 */
3306 public static final int INCALL_POWER_BUTTON_BEHAVIOR_DEFAULT =
3307 INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF;
3308
3309 /**
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07003310 * The current night mode that has been selected by the user. Owned
3311 * and controlled by UiModeManagerService. Constants are as per
3312 * UiModeManager.
3313 * @hide
3314 */
3315 public static final String UI_NIGHT_MODE = "ui_night_mode";
Suchi Amalapurapu40e47252010-04-07 16:15:50 -07003316
3317 /**
3318 * Let user pick default install location.
3319 * @hide
3320 */
3321 public static final String SET_INSTALL_LOCATION = "set_install_location";
3322
3323 /**
3324 * Default install location value.
3325 * 0 = auto, let system decide
3326 * 1 = internal
3327 * 2 = sdcard
3328 * @hide
3329 */
3330 public static final String DEFAULT_INSTALL_LOCATION = "default_install_location";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003331
3332 /**
3333 * The bandwidth throttle polling freqency in seconds
3334 * @hide
3335 */
3336 public static final String THROTTLE_POLLING_SEC = "throttle_polling_sec";
3337
3338 /**
3339 * The bandwidth throttle threshold (long)
3340 * @hide
3341 */
Robert Greenwaltd3bb93f2010-04-12 19:20:55 -07003342 public static final String THROTTLE_THRESHOLD_BYTES = "throttle_threshold_bytes";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003343
3344 /**
3345 * The bandwidth throttle value (kbps)
3346 * @hide
3347 */
Robert Greenwaltd3bb93f2010-04-12 19:20:55 -07003348 public static final String THROTTLE_VALUE_KBITSPS = "throttle_value_kbitsps";
Robert Greenwalt9e696c22010-04-01 14:45:18 -07003349
3350 /**
3351 * The bandwidth throttle reset calendar day (1-28)
3352 * @hide
3353 */
3354 public static final String THROTTLE_RESET_DAY = "throttle_reset_day";
3355
3356 /**
3357 * The throttling notifications we should send
3358 * @hide
3359 */
3360 public static final String THROTTLE_NOTIFICATION_TYPE = "throttle_notification_type";
3361
3362 /**
Irfan Sheriffc9b68512010-04-08 14:12:33 -07003363 * Help URI for data throttling policy
3364 * @hide
3365 */
3366 public static final String THROTTLE_HELP_URI = "throttle_help_uri";
3367
Robert Greenwaltd1055a22010-05-25 15:54:52 -07003368 /**
3369 * The length of time in Sec that we allow our notion of NTP time
3370 * to be cached before we refresh it
3371 * @hide
3372 */
3373 public static final String THROTTLE_MAX_NTP_CACHE_AGE_SEC =
3374 "throttle_max_ntp_cache_age_sec";
3375
Irfan Sheriffc9b68512010-04-08 14:12:33 -07003376
3377 /**
-b master501eec92009-07-06 13:53:11 -07003378 * @hide
3379 */
3380 public static final String[] SETTINGS_TO_BACKUP = {
Amith Yamasani8823c0a82009-07-07 14:30:17 -07003381 ADB_ENABLED,
3382 ALLOW_MOCK_LOCATION,
-b master501eec92009-07-06 13:53:11 -07003383 PARENTAL_CONTROL_ENABLED,
3384 PARENTAL_CONTROL_REDIRECT_URL,
3385 USB_MASS_STORAGE_ENABLED,
3386 ACCESSIBILITY_ENABLED,
Christopher Tate14c2d792010-02-25 16:49:44 -08003387 BACKUP_AUTO_RESTORE,
-b master501eec92009-07-06 13:53:11 -07003388 ENABLED_ACCESSIBILITY_SERVICES,
3389 TTS_USE_DEFAULTS,
3390 TTS_DEFAULT_RATE,
3391 TTS_DEFAULT_PITCH,
3392 TTS_DEFAULT_SYNTH,
3393 TTS_DEFAULT_LANG,
3394 TTS_DEFAULT_COUNTRY,
Charles Chenceffa152010-03-16 21:18:10 -07003395 TTS_ENABLED_PLUGINS,
-b master501eec92009-07-06 13:53:11 -07003396 WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,
3397 WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,
3398 WIFI_NUM_ALLOWED_CHANNELS,
3399 WIFI_NUM_OPEN_NETWORKS_KEPT,
San Mehat87734d32010-01-08 12:53:06 -08003400 MOUNT_PLAY_NOTIFICATION_SND,
3401 MOUNT_UMS_AUTOSTART,
3402 MOUNT_UMS_PROMPT,
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07003403 MOUNT_UMS_NOTIFY_ENABLED,
3404 UI_NIGHT_MODE
-b master501eec92009-07-06 13:53:11 -07003405 };
3406
3407 /**
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003408 * Helper method for determining if a location provider is enabled.
3409 * @param cr the content resolver to use
3410 * @param provider the location provider to query
3411 * @return true if the provider is enabled
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003412 */
3413 public static final boolean isLocationProviderEnabled(ContentResolver cr, String provider) {
3414 String allowedProviders = Settings.Secure.getString(cr, LOCATION_PROVIDERS_ALLOWED);
3415 if (allowedProviders != null) {
3416 return (allowedProviders.equals(provider) ||
3417 allowedProviders.contains("," + provider + ",") ||
3418 allowedProviders.startsWith(provider + ",") ||
3419 allowedProviders.endsWith("," + provider));
3420 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003421 return false;
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003422 }
3423
3424 /**
3425 * Thread-safe method for enabling or disabling a single location provider.
3426 * @param cr the content resolver to use
3427 * @param provider the location provider to enable or disable
3428 * @param enabled true if the provider should be enabled
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07003429 */
3430 public static final void setLocationProviderEnabled(ContentResolver cr,
3431 String provider, boolean enabled) {
3432 // to ensure thread safety, we write the provider name with a '+' or '-'
3433 // and let the SettingsProvider handle it rather than reading and modifying
3434 // the list of enabled providers.
3435 if (enabled) {
3436 provider = "+" + provider;
3437 } else {
3438 provider = "-" + provider;
3439 }
3440 putString(cr, Settings.Secure.LOCATION_PROVIDERS_ALLOWED, provider);
3441 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003442 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003443
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003444 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003445 * User-defined bookmarks and shortcuts. The target of each bookmark is an
3446 * Intent URL, allowing it to be either a web page or a particular
3447 * application activity.
3448 *
3449 * @hide
3450 */
3451 public static final class Bookmarks implements BaseColumns
3452 {
3453 private static final String TAG = "Bookmarks";
3454
3455 /**
3456 * The content:// style URL for this table
3457 */
3458 public static final Uri CONTENT_URI =
3459 Uri.parse("content://" + AUTHORITY + "/bookmarks");
3460
3461 /**
3462 * The row ID.
3463 * <p>Type: INTEGER</p>
3464 */
3465 public static final String ID = "_id";
3466
3467 /**
3468 * Descriptive name of the bookmark that can be displayed to the user.
3469 * If this is empty, the title should be resolved at display time (use
3470 * {@link #getTitle(Context, Cursor)} any time you want to display the
3471 * title of a bookmark.)
3472 * <P>
3473 * Type: TEXT
3474 * </P>
3475 */
3476 public static final String TITLE = "title";
3477
3478 /**
3479 * Arbitrary string (displayed to the user) that allows bookmarks to be
3480 * organized into categories. There are some special names for
3481 * standard folders, which all start with '@'. The label displayed for
3482 * the folder changes with the locale (via {@link #getLabelForFolder}) but
3483 * the folder name does not change so you can consistently query for
3484 * the folder regardless of the current locale.
3485 *
3486 * <P>Type: TEXT</P>
3487 *
3488 */
3489 public static final String FOLDER = "folder";
3490
3491 /**
3492 * The Intent URL of the bookmark, describing what it points to. This
3493 * value is given to {@link android.content.Intent#getIntent} to create
3494 * an Intent that can be launched.
3495 * <P>Type: TEXT</P>
3496 */
3497 public static final String INTENT = "intent";
3498
3499 /**
3500 * Optional shortcut character associated with this bookmark.
3501 * <P>Type: INTEGER</P>
3502 */
3503 public static final String SHORTCUT = "shortcut";
3504
3505 /**
3506 * The order in which the bookmark should be displayed
3507 * <P>Type: INTEGER</P>
3508 */
3509 public static final String ORDERING = "ordering";
3510
3511 private static final String[] sIntentProjection = { INTENT };
3512 private static final String[] sShortcutProjection = { ID, SHORTCUT };
3513 private static final String sShortcutSelection = SHORTCUT + "=?";
3514
3515 /**
3516 * Convenience function to retrieve the bookmarked Intent for a
3517 * particular shortcut key.
3518 *
3519 * @param cr The ContentResolver to query.
3520 * @param shortcut The shortcut key.
3521 *
3522 * @return Intent The bookmarked URL, or null if there is no bookmark
3523 * matching the given shortcut.
3524 */
3525 public static Intent getIntentForShortcut(ContentResolver cr, char shortcut)
3526 {
3527 Intent intent = null;
3528
3529 Cursor c = cr.query(CONTENT_URI,
3530 sIntentProjection, sShortcutSelection,
3531 new String[] { String.valueOf((int) shortcut) }, ORDERING);
3532 // Keep trying until we find a valid shortcut
3533 try {
3534 while (intent == null && c.moveToNext()) {
3535 try {
3536 String intentURI = c.getString(c.getColumnIndexOrThrow(INTENT));
3537 intent = Intent.getIntent(intentURI);
3538 } catch (java.net.URISyntaxException e) {
3539 // The stored URL is bad... ignore it.
3540 } catch (IllegalArgumentException e) {
3541 // Column not found
Dianne Hackborna33e3f72009-09-29 17:28:24 -07003542 Log.w(TAG, "Intent column not found", e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003543 }
3544 }
3545 } finally {
3546 if (c != null) c.close();
3547 }
3548
3549 return intent;
3550 }
3551
3552 /**
3553 * Add a new bookmark to the system.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003554 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003555 * @param cr The ContentResolver to query.
3556 * @param intent The desired target of the bookmark.
3557 * @param title Bookmark title that is shown to the user; null if none
3558 * or it should be resolved to the intent's title.
3559 * @param folder Folder in which to place the bookmark; null if none.
3560 * @param shortcut Shortcut that will invoke the bookmark; 0 if none. If
3561 * this is non-zero and there is an existing bookmark entry
3562 * with this same shortcut, then that existing shortcut is
3563 * cleared (the bookmark is not removed).
3564 * @return The unique content URL for the new bookmark entry.
3565 */
3566 public static Uri add(ContentResolver cr,
3567 Intent intent,
3568 String title,
3569 String folder,
3570 char shortcut,
3571 int ordering)
3572 {
3573 // If a shortcut is supplied, and it is already defined for
3574 // another bookmark, then remove the old definition.
3575 if (shortcut != 0) {
3576 Cursor c = cr.query(CONTENT_URI,
3577 sShortcutProjection, sShortcutSelection,
3578 new String[] { String.valueOf((int) shortcut) }, null);
3579 try {
3580 if (c.moveToFirst()) {
3581 while (c.getCount() > 0) {
3582 if (!c.deleteRow()) {
3583 Log.w(TAG, "Could not delete existing shortcut row");
3584 }
3585 }
3586 }
3587 } finally {
3588 if (c != null) c.close();
3589 }
3590 }
3591
3592 ContentValues values = new ContentValues();
3593 if (title != null) values.put(TITLE, title);
3594 if (folder != null) values.put(FOLDER, folder);
3595 values.put(INTENT, intent.toURI());
3596 if (shortcut != 0) values.put(SHORTCUT, (int) shortcut);
3597 values.put(ORDERING, ordering);
3598 return cr.insert(CONTENT_URI, values);
3599 }
3600
3601 /**
3602 * Return the folder name as it should be displayed to the user. This
3603 * takes care of localizing special folders.
3604 *
3605 * @param r Resources object for current locale; only need access to
3606 * system resources.
3607 * @param folder The value found in the {@link #FOLDER} column.
3608 *
3609 * @return CharSequence The label for this folder that should be shown
3610 * to the user.
3611 */
3612 public static CharSequence getLabelForFolder(Resources r, String folder) {
3613 return folder;
3614 }
3615
3616 /**
3617 * Return the title as it should be displayed to the user. This takes
3618 * care of localizing bookmarks that point to activities.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003619 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003620 * @param context A context.
3621 * @param cursor A cursor pointing to the row whose title should be
3622 * returned. The cursor must contain at least the {@link #TITLE}
3623 * and {@link #INTENT} columns.
3624 * @return A title that is localized and can be displayed to the user,
3625 * or the empty string if one could not be found.
3626 */
3627 public static CharSequence getTitle(Context context, Cursor cursor) {
3628 int titleColumn = cursor.getColumnIndex(TITLE);
3629 int intentColumn = cursor.getColumnIndex(INTENT);
3630 if (titleColumn == -1 || intentColumn == -1) {
3631 throw new IllegalArgumentException(
3632 "The cursor must contain the TITLE and INTENT columns.");
3633 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003634
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003635 String title = cursor.getString(titleColumn);
3636 if (!TextUtils.isEmpty(title)) {
3637 return title;
3638 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003639
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003640 String intentUri = cursor.getString(intentColumn);
3641 if (TextUtils.isEmpty(intentUri)) {
3642 return "";
3643 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003644
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003645 Intent intent;
3646 try {
3647 intent = Intent.getIntent(intentUri);
3648 } catch (URISyntaxException e) {
3649 return "";
3650 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003651
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003652 PackageManager packageManager = context.getPackageManager();
3653 ResolveInfo info = packageManager.resolveActivity(intent, 0);
3654 return info != null ? info.loadLabel(packageManager) : "";
3655 }
3656 }
3657
3658 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003659 * Returns the device ID that we should use when connecting to the mobile gtalk server.
3660 * This is a string like "android-0x1242", where the hex string is the Android ID obtained
3661 * from the GoogleLoginService.
3662 *
3663 * @param androidId The Android ID for this device.
3664 * @return The device ID that should be used when connecting to the mobile gtalk server.
3665 * @hide
3666 */
3667 public static String getGTalkDeviceId(long androidId) {
3668 return "android-" + Long.toHexString(androidId);
3669 }
3670}