PendingIntent.java revision 1927ae8a56a010919a7535231fa0f7db70f7e152
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IntentSender; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AndroidException; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A description of an Intent and target action to perform with it. Instances 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of this class are created with {@link #getActivity}, 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, {@link #getService}; the returned object can be 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handed to other applications so that they can perform the action you 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * described on your behalf at a later time. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>By giving a PendingIntent to another application, 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you are granting it the right to perform the operation you have specified 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if the other application was yourself (with the same permissions and 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identity). As such, you should be careful about how you build the PendingIntent: 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often, for example, the base Intent you supply will have the component 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name explicitly set to one of your own components, to ensure it is ultimately 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sent there and nowhere else. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A PendingIntent itself is simply a reference to a token maintained by 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system describing the original data used to retrieve it. This means 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that, even if its owning application's process is killed, the 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent itself will remain usable from other processes that 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been given it. If the creating application later re-retrieves the 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same kind of PendingIntent (same operation, same Intent action, data, 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * categories, and components, and same flags), it will receive a PendingIntent 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing the same token if that is still valid, and can thus call 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #cancel} to remove it. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class PendingIntent implements Parcelable { 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IIntentSender mTarget; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: this 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent can only be used once. If set, after 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #send()} is called on it, it will be automatically 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canceled for you and any future attempt to send through it will fail. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ONE_SHOT = 1<<30; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent does not already 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exist, then simply return null instead of creating it. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_NO_CREATE = 1<<29; 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current one is canceled before generating a new one. You can use 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to retrieve a new PendingIntent when you are only changing the 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extra data in the Intent; by canceling the previous pending intent, 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this ensures that only entities given the new data will be able to 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * launch it. If this assurance is not an issue, consider 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_UPDATE_CURRENT}. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_CANCEL_CURRENT = 1<<28; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then keep it but its replace its extra data with what is in this new 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent. This can be used if you are creating intents where only the 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras change, and don't care that any entities that received your 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous PendingIntent will be able to launch it with your new 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras even if they are not explicitly given to it. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_UPDATE_CURRENT = 1<<27; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exception thrown when trying to send through a PendingIntent that 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been canceled or is otherwise no longer able to execute the request. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CanceledException extends AndroidException { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException() { 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(String name) { 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(name); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(Exception cause) { 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(cause); 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for discovering when a send operation has 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed. Primarily for use with a PendingIntent that is 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performing a broadcast, this provides the same information as 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Context#sendOrderedBroadcast(Intent, String, 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.content.BroadcastReceiver, Handler, int, String, Bundle) 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.sendBroadcast()} with a final BroadcastReceiver. 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnFinished { 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a send operation as completed. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pendingIntent The PendingIntent this operation was sent through. 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The original Intent that was sent. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultCode The final result code determined by the send. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultData The final data collected by a broadcast. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultExtras The final extras collected by a broadcast. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSendFinished(PendingIntent pendingIntent, Intent intent, 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resultCode, String resultData, Bundle resultExtras); 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static class FinishedDispatcher extends IIntentReceiver.Stub 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Runnable { 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final PendingIntent mPendingIntent; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final OnFinished mWho; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Intent mIntent; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mResultCode; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mResultData; 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bundle mResultExtras; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project FinishedDispatcher(PendingIntent pi, OnFinished who, Handler handler) { 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPendingIntent = pi; 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho = who; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void performReceive(Intent intent, int resultCode, 15068d881cf2d2b252f6f795cd64d43e316a1d736e5Dianne Hackborn String data, Bundle extras, boolean serialized, boolean sticky) { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIntent = intent; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultCode = resultCode; 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData = data; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultExtras = extras; 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler == null) { 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project run(); 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.post(this); 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho.onSendFinished(mPendingIntent, mIntent, mResultCode, 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData, mResultExtras); 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 1917a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 1927a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 1937a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 1947a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 1957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 1967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 1977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 1987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 1997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2007a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2017a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 2037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 2047a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 2057a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2067a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2077a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2087a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2097a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2107a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2117a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2127a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2137a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2147a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 2157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2167a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 2177a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 2187a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 2197a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent intent, int flags, Bundle options) { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2249ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 227a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 228621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn flags, options); 231621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 232621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 233621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 234621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 235621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 236621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 237621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 238621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 239621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * array of Intents to be supplied. The first Intent in the array is 240621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 241621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 242621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 243621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 244621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 245621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 246621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 247621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 248621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 249621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 250621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 251621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 252621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 253621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 254621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 255621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 256621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 257621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 258621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 259621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 260621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 261621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 262621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 263621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 264621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 265621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param requestCode Private request code for the sender (currently 266621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * not used). 267621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 268621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 269621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 270621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 271621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 272621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 273621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 274621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 275621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 276621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 277621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 278621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 279621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn Intent[] intents, int flags) { 2807a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 2817a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2827a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2837a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2847a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 2857a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * array of Intents to be supplied. The first Intent in the array is 2867a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 2877a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 2887a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 2897a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 2907a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2917a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 2927a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 2937a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2947a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 2957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 2967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 2977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 2987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3007a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 3017a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 3027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 3037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 3047a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 3057a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 3067a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 3077a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3087a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3097a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 3107a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 3117a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 3127a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 3137a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 3147a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3167a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 3177a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3187a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 3197a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3247a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 3257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent[] intents, int flags, Bundle options) { 326621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 327621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 328621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 3299ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intents[i].setAllowFds(false); 330621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 331621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 332621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 333621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 334621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 335a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options); 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3689ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 371a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 372621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn flags, null); 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4079ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 410a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 411621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4127a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 4137a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn flags, null); 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 4211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 4221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 4241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 4261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 4277f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 4281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 4291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 432f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 4506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, 0, null, null, null, null); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 4646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, null, null, null); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent) 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 4846c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, null, null, null); 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code, OnFinished onFinished, Handler handler) 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 5056c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, onFinished, handler, null); 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 5346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent, 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnFinished onFinished, Handler handler) throws CanceledException { 5416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, onFinished, handler, null); 5426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 5436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 5446c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 5456c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 5466c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 5476c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 5486c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 5496c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 5506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 5516c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 5526c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 5536c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 5546c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 5556c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 5566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 5576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 5586c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 5596c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 5606c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 5616c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 5626c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 5636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 5646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 5656c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 5666c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 5676c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 5686c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 5696c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 5706c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 5716c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 5726c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 5736c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 5746c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 5756c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 5766c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 5776c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 5786c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 5796c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 5806c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void send(Context context, int code, Intent intent, 5816c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 5826c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 5896c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 5906c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 5916c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getTargetPackage() { 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6206c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 6216c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 6226c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 6236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 6246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 6256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 6266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 6276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 6286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 6296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 6306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 6316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 6326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 6336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 6341927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 6351927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 6361927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 6371927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 6381927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 6391927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 6401927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 6411927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 6421927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 6431927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 6441927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 6451927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 6461927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 6471927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 6721d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 6731d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 6741d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 6751d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 6761d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 6771d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 6781d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void writePendingIntentOrNullToParcel(PendingIntent sender, 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel out) { 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent readPendingIntentOrNullFromParcel(Parcel in) { 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 738bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 739bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 743