PendingIntent.java revision 50cdf7c3069eb2cf82acbad73c322b7a5f3af4b1
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; 30f02b60aa4f367516f40cf3d60fffae0c6fe3e1b8Dianne Hackbornimport android.os.UserHandle; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AndroidException; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A description of an Intent and target action to perform with it. Instances 358832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * of this class are created with {@link #getActivity}, {@link #getActivities}, 368832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, and {@link #getService}; the returned object can be 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handed to other applications so that they can perform the action you 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * described on your behalf at a later time. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>By giving a PendingIntent to another application, 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you are granting it the right to perform the operation you have specified 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if the other application was yourself (with the same permissions and 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identity). As such, you should be careful about how you build the PendingIntent: 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often, for example, the base Intent you supply will have the component 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name explicitly set to one of your own components, to ensure it is ultimately 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sent there and nowhere else. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A PendingIntent itself is simply a reference to a token maintained by 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system describing the original data used to retrieve it. This means 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that, even if its owning application's process is killed, the 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent itself will remain usable from other processes that 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been given it. If the creating application later re-retrieves the 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same kind of PendingIntent (same operation, same Intent action, data, 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * categories, and components, and same flags), it will receive a PendingIntent 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing the same token if that is still valid, and can thus call 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #cancel} to remove it. 578832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 588832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>Because of this behavior, it is important to know when two Intents 598832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * are considered to be the same for purposes of retrieving a PendingIntent. 608832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * A common mistake people make is to create multiple PendingIntent objects 618832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * with Intents that only vary in their "extra" contents, expecting to get 628832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * a different PendingIntent each time. This does <em>not</em> happen. The 638832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * parts of the Intent that are used for matching are the same ones defined 648832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * by {@link Intent#filterEquals(Intent) Intent.filterEquals}. If you use two 658832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent objects that are equivalent as per 668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, then you will get 678832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same PendingIntent for both of them. 688832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 698832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>There are two typical ways to deal with this. 708832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 718832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you truly need multiple distinct PendingIntent objects active at 728832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same time (such as to use as two notifications that are both shown 738832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * at the same time), then you will need to ensure there is something that 748832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * is different about them to associate them with different PendingIntents. 758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * This may be any of the Intent attributes considered by 768832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, or different 778832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * request code integers supplied to {@link #getActivity}, {@link #getActivities}, 788832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 808832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you only need one PendingIntent active at a time for any of the 818832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intents you will use, then you can alternatively use the flags 828832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT} or {@link #FLAG_UPDATE_CURRENT} to either 838832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * cancel or modify whatever current PendingIntent is associated with the 848832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent you are supplying. 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class PendingIntent implements Parcelable { 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IIntentSender mTarget; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: this 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent can only be used once. If set, after 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #send()} is called on it, it will be automatically 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canceled for you and any future attempt to send through it will fail. 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ONE_SHOT = 1<<30; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent does not already 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exist, then simply return null instead of creating it. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_NO_CREATE = 1<<29; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current one is canceled before generating a new one. You can use 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to retrieve a new PendingIntent when you are only changing the 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extra data in the Intent; by canceling the previous pending intent, 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this ensures that only entities given the new data will be able to 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * launch it. If this assurance is not an issue, consider 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_UPDATE_CURRENT}. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_CANCEL_CURRENT = 1<<28; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then keep it but its replace its extra data with what is in this new 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent. This can be used if you are creating intents where only the 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras change, and don't care that any entities that received your 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous PendingIntent will be able to launch it with your new 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras even if they are not explicitly given to it. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_UPDATE_CURRENT = 1<<27; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exception thrown when trying to send through a PendingIntent that 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been canceled or is otherwise no longer able to execute the request. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CanceledException extends AndroidException { 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException() { 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(String name) { 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(name); 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(Exception cause) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(cause); 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for discovering when a send operation has 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed. Primarily for use with a PendingIntent that is 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performing a broadcast, this provides the same information as 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Context#sendOrderedBroadcast(Intent, String, 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.content.BroadcastReceiver, Handler, int, String, Bundle) 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.sendBroadcast()} with a final BroadcastReceiver. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnFinished { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a send operation as completed. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pendingIntent The PendingIntent this operation was sent through. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The original Intent that was sent. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultCode The final result code determined by the send. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultData The final data collected by a broadcast. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultExtras The final extras collected by a broadcast. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSendFinished(PendingIntent pendingIntent, Intent intent, 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resultCode, String resultData, Bundle resultExtras); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static class FinishedDispatcher extends IIntentReceiver.Stub 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Runnable { 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final PendingIntent mPendingIntent; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final OnFinished mWho; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Intent mIntent; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mResultCode; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mResultData; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bundle mResultExtras; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project FinishedDispatcher(PendingIntent pi, OnFinished who, Handler handler) { 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPendingIntent = pi; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho = who; 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17820e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn public void performReceive(Intent intent, int resultCode, String data, 17920e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn Bundle extras, boolean serialized, boolean sticky, int sendingUser) { 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIntent = intent; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultCode = resultCode; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData = data; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultExtras = extras; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler == null) { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project run(); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.post(this); 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho.onSendFinished(mPendingIntent, mIntent, mResultCode, 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData, mResultExtras); 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 2207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 2217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2247a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 2257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2267a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 2277a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2287a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 2327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 2337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 2347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 2447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 2467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 2477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 2487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent intent, int flags, Bundle options) { 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2539ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 256a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 257621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2594120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 2604120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 2614120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 2624120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2634120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 2644120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2654120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 2664120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 2674120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 26850cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 26950cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * activity is started, not when the pending intent is created. 2704120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 2714120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 2724120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn Intent intent, int flags, Bundle options, UserHandle user) { 2734120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 2744120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2754120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 2764120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 2774120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn intent.setAllowFds(false); 2784120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 2794120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 2804120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 2814120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2824120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2834120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 284621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 285621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 286621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 287621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 288621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 289621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 290621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 291621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 292621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * array of Intents to be supplied. The first Intent in the array is 293621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 294621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 295621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 296621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 297621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 298621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 299621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 300621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 301621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 302621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 303621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 304621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 305621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 306621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 307621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 308621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 309621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 310621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 311621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 312621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 313621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 314621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 315621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 316621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 317621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 318621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param requestCode Private request code for the sender (currently 319621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * not used). 320621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 321621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 322621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 323621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 324621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 325621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 326621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 327621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 328621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 329621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 330621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 331621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 332621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn Intent[] intents, int flags) { 3337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 3347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * array of Intents to be supplied. The first Intent in the array is 3397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 3407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 3417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 3427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 3437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 3467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 3477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 3487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 3497a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 3507a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3517a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 3547a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 3557a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 3567a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 3577a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 3587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 3597a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 3607a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3617a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3627a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 3637a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 3647a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 3657a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 3667a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 3677a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3687a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3697a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 3707a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3717a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 3727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 3787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent[] intents, int flags, Bundle options) { 379621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 380621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 381621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 3829ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intents[i].setAllowFds(false); 383621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 384621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 385621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 386621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 387621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 388a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3894120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 3904120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 418599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani return getBroadcastAsUser(context, requestCode, intent, flags, 419599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani new UserHandle(UserHandle.myUserId())); 420599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani } 421599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani 42250cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn /** 42350cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * @hide 42450cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 42550cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * broadcast is sent, not when the pending intent is created. 42650cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn */ 427599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani public static PendingIntent getBroadcastAsUser(Context context, int requestCode, 428599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani Intent intent, int flags, UserHandle userHandle) { 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4339ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 436a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 437621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 439599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani flags, null, userHandle.getIdentifier()); 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4729ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 475a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 476621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 4784120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 4861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 4871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 4891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 4911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 4927f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 4931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 4941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 497f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 5156c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, 0, null, null, null, null); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 5296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, null, null, null); 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent) 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 5496c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, null, null, null); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code, OnFinished onFinished, Handler handler) 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 5706c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, onFinished, handler, null); 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 5996c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent, 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnFinished onFinished, Handler handler) throws CanceledException { 6066c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, onFinished, handler, null); 6076c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 6086c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 6096c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 6106c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 6116c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 6126c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 6136c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6146c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 6156c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 6166c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 6176c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 6186c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6196c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 6206c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 6216c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 6226c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 6236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 6246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 6256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 6266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 6276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 6286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 6296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 6306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 6316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 6326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 6336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 6346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 6356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 6376c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 6386c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 6396c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 6406c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 6416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 6436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 6446c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 6456c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void send(Context context, int code, Intent intent, 6466c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 6476c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 6546c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 6556c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 6566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 6678832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 6688832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 6698832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 6708832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 6718832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 6728832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 6738832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 6748832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 6758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 6768832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 6778832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 6788832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 6798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6888832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 699c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 700c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 701c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 702c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 703c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 704c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 705c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 706c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 7078832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 708c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 709c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 710c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 711c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 712c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 713c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 714c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 715c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 716c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 717c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 718c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 719c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 72079af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 721c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 722c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 723c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 724c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 72579af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 726c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 727c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 7288832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 729c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 730c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 731c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 73279af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 733c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 734c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 73579af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 736c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 737c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 738c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 739c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 7406c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 7416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 7426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 7436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 7446c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 7456c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 7466c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 7476c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 7486c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 7496c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 7506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7516c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7526c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 7536c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 7541927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 7551927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 7561927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 7571927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 7581927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 7591927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 7601927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 7611927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 7621927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 7631927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 7641927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 7651927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 7661927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 7671927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 7921d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 7931d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 7941d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 7951d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 7961d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 7971d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 7981d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void writePendingIntentOrNullToParcel(PendingIntent sender, 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel out) { 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent readPendingIntentOrNullFromParcel(Parcel in) { 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 858bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 859bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 863