diff options
author | Jeff Hamilton <jham@android.com> | 2011-02-09 12:27:01 +0900 |
---|---|---|
committer | Jeff Hamilton <jham@android.com> | 2011-02-09 12:30:18 +0900 |
commit | 167d9e473f9240d452b25218625c326f31eebbaa (patch) | |
tree | 5d726aa67e94dda5e0f1a6273e912b0fe0c2cfa8 /core/java | |
parent | cdfe899991c365d9e197d83f8859089cae082011 (diff) | |
download | frameworks_base-167d9e473f9240d452b25218625c326f31eebbaa.zip frameworks_base-167d9e473f9240d452b25218625c326f31eebbaa.tar.gz frameworks_base-167d9e473f9240d452b25218625c326f31eebbaa.tar.bz2 |
Improve the docs a bit for foreground dispatch.
Change-Id: I4179133a0956bc66a49201c20f1dd2d6d67874d2
Diffstat (limited to 'core/java')
-rw-r--r-- | core/java/android/nfc/NfcAdapter.java | 23 |
1 files changed, 17 insertions, 6 deletions
diff --git a/core/java/android/nfc/NfcAdapter.java b/core/java/android/nfc/NfcAdapter.java index f59d9cf..297f15b 100644 --- a/core/java/android/nfc/NfcAdapter.java +++ b/core/java/android/nfc/NfcAdapter.java @@ -419,18 +419,29 @@ public final class NfcAdapter { * <p>This will give give priority to the foreground activity when * dispatching a discovered {@link Tag} to an application. * - * <p>Activities must call {@link #disableForegroundDispatch} in - * their {@link Activity#onPause} callback. + * <p>If any IntentFilters are provided to this method they are used to match dispatch Intents + * for both the {@link NfcAdapter#ACTION_NDEF_DISCOVERED} and + * {@link NfcAdapter#ACTION_TAG_DISCOVERED}. Since {@link NfcAdapter#ACTION_TECH_DISCOVERED} + * relies on meta data outside of the IntentFilter matching for that dispatch Intent is handled + * by passing in the tech lists separately. Each first level entry in the tech list represents + * an array of technologies that must all be present to match. If any of the first level sets + * match then the dispatch is routed through the given PendingIntent. In other words, the second + * level is ANDed together and the first level entries are ORed together. * - * <p>a null set of intent filters will cause the forground activity - * to receive all tags. + * <p>If you pass {@code null} for both the {@code filters} and {@code techLists} parameters + * that acts a wild card and will cause the foreground activity to receive all tags via the + * {@link NfcAdapter#ACTION_TAG_DISCOVERED} intent. * - * <p>This method must be called from the main thread, and - * only when the activity is in the foreground (resumed). * + * <p>This method must be called from the main thread, and only when the activity is in the + * foreground (resumed). Also, activities must call {@link #disableForegroundDispatch} before + * the completion of their {@link Activity#onPause} callback to disable foreground dispatch + * after it has been enabled. * * @param activity the Activity to dispatch to * @param intent the PendingIntent to start for the dispatch * @param filters the IntentFilters to override dispatching for, or null to always dispatch + * @param techLists the tech lists used to perform matching for dispatching of the + * {@link NfcAdapter#ACTION_TECH_DISCOVERED} intent * @throws IllegalStateException if the Activity is not currently in the foreground */ public void enableForegroundDispatch(Activity activity, PendingIntent intent, |