IActivityManager.aidl revision 4d27b84d9579197875f6fbe2d0ac211b374c5a3a
1/*
2 * Copyright (C) 2016 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.app;
18
19import android.app.ActivityManager;
20import android.app.ApplicationErrorReport;
21import android.app.ContentProviderHolder;
22import android.app.IApplicationThread;
23import android.app.IActivityController;
24import android.app.IAppTask;
25import android.app.IInstrumentationWatcher;
26import android.app.IProcessObserver;
27import android.app.IServiceConnection;
28import android.app.IStopUserCallback;
29import android.app.ITaskStackListener;
30import android.app.IUiAutomationConnection;
31import android.app.IUidObserver;
32import android.app.IUserSwitchObserver;
33import android.app.Notification;
34import android.app.PendingIntent;
35import android.app.PictureInPictureParams;
36import android.app.ProfilerInfo;
37import android.app.WaitResult;
38import android.app.assist.AssistContent;
39import android.app.assist.AssistStructure;
40import android.content.ComponentName;
41import android.content.IIntentReceiver;
42import android.content.IIntentSender;
43import android.content.Intent;
44import android.content.IntentFilter;
45import android.content.IntentSender;
46import android.content.pm.ApplicationInfo;
47import android.content.pm.ConfigurationInfo;
48import android.content.pm.IPackageDataObserver;
49import android.content.pm.ParceledListSlice;
50import android.content.pm.ProviderInfo;
51import android.content.pm.UserInfo;
52import android.content.res.Configuration;
53import android.graphics.Bitmap;
54import android.graphics.GraphicBuffer;
55import android.graphics.Point;
56import android.graphics.Rect;
57import android.net.Uri;
58import android.os.Bundle;
59import android.os.Debug;
60import android.os.IBinder;
61import android.os.IProgressListener;
62import android.os.ParcelFileDescriptor;
63import android.os.PersistableBundle;
64import android.os.StrictMode;
65import android.service.voice.IVoiceInteractionSession;
66import com.android.internal.app.IVoiceInteractor;
67import com.android.internal.os.IResultReceiver;
68import com.android.internal.policy.IKeyguardDismissCallback;
69
70import java.util.List;
71
72/**
73 * System private API for talking with the activity manager service.  This
74 * provides calls from the application back to the activity manager.
75 *
76 * {@hide}
77 */
78interface IActivityManager {
79    // WARNING: when these transactions are updated, check if they are any callers on the native
80    // side. If so, make sure they are using the correct transaction ids and arguments.
81    // If a transaction which will also be used on the native side is being inserted, add it to
82    // below block of transactions.
83
84    // Since these transactions are also called from native code, these must be kept in sync with
85    // the ones in frameworks/native/include/binder/IActivityManager.h
86    // =============== Beginning of transactions used on native side as well ======================
87    ParcelFileDescriptor openContentUri(in String uriString);
88    // =============== End of transactions used on native side as well ============================
89
90    // Special low-level communication with activity manager.
91    void handleApplicationCrash(in IBinder app,
92            in ApplicationErrorReport.ParcelableCrashInfo crashInfo);
93    int startActivity(in IApplicationThread caller, in String callingPackage, in Intent intent,
94            in String resolvedType, in IBinder resultTo, in String resultWho, int requestCode,
95            int flags, in ProfilerInfo profilerInfo, in Bundle options);
96    void unhandledBack();
97
98    boolean finishActivity(in IBinder token, int code, in Intent data, int finishTask);
99    Intent registerReceiver(in IApplicationThread caller, in String callerPackage,
100            in IIntentReceiver receiver, in IntentFilter filter,
101            in String requiredPermission, int userId, int flags);
102    void unregisterReceiver(in IIntentReceiver receiver);
103    int broadcastIntent(in IApplicationThread caller, in Intent intent,
104            in String resolvedType, in IIntentReceiver resultTo, int resultCode,
105            in String resultData, in Bundle map, in String[] requiredPermissions,
106            int appOp, in Bundle options, boolean serialized, boolean sticky, int userId);
107    void unbroadcastIntent(in IApplicationThread caller, in Intent intent, int userId);
108    oneway void finishReceiver(in IBinder who, int resultCode, in String resultData, in Bundle map,
109            boolean abortBroadcast, int flags);
110    void attachApplication(in IApplicationThread app);
111    oneway void activityIdle(in IBinder token, in Configuration config,
112            in boolean stopProfiling);
113    void activityPaused(in IBinder token);
114    oneway void activityStopped(in IBinder token, in Bundle state,
115            in PersistableBundle persistentState, in CharSequence description);
116    String getCallingPackage(in IBinder token);
117    ComponentName getCallingActivity(in IBinder token);
118    List<ActivityManager.RunningTaskInfo> getTasks(int maxNum, int flags);
119    void moveTaskToFront(int task, int flags, in Bundle options);
120    void moveTaskBackwards(int task);
121    int getTaskForActivity(in IBinder token, in boolean onlyRoot);
122    ContentProviderHolder getContentProvider(in IApplicationThread caller,
123            in String name, int userId, boolean stable);
124    void publishContentProviders(in IApplicationThread caller,
125            in List<ContentProviderHolder> providers);
126    boolean refContentProvider(in IBinder connection, int stableDelta, int unstableDelta);
127    void finishSubActivity(in IBinder token, in String resultWho, int requestCode);
128    PendingIntent getRunningServiceControlPanel(in ComponentName service);
129    ComponentName startService(in IApplicationThread caller, in Intent service,
130            in String resolvedType, boolean requireForeground, in String callingPackage, int userId);
131    int stopService(in IApplicationThread caller, in Intent service,
132            in String resolvedType, int userId);
133    int bindService(in IApplicationThread caller, in IBinder token, in Intent service,
134            in String resolvedType, in IServiceConnection connection, int flags,
135            in String callingPackage, int userId);
136    boolean unbindService(in IServiceConnection connection);
137    void publishService(in IBinder token, in Intent intent, in IBinder service);
138    void activityResumed(in IBinder token);
139    void setDebugApp(in String packageName, boolean waitForDebugger, boolean persistent);
140    void setAlwaysFinish(boolean enabled);
141    boolean startInstrumentation(in ComponentName className, in String profileFile,
142            int flags, in Bundle arguments, in IInstrumentationWatcher watcher,
143            in IUiAutomationConnection connection, int userId,
144            in String abiOverride);
145    void addInstrumentationResults(in IApplicationThread target, in Bundle results);
146    void finishInstrumentation(in IApplicationThread target, int resultCode,
147            in Bundle results);
148    /**
149     * @return A copy of global {@link Configuration}, contains general settings for the entire
150     *         system. Corresponds to the configuration of the default display.
151     * @throws RemoteException
152     */
153    Configuration getConfiguration();
154    /**
155     * Updates global configuration and applies changes to the entire system.
156     * @param values Update values for global configuration. If null is passed it will request the
157     *               Window Manager to compute new config for the default display.
158     * @throws RemoteException
159     * @return Returns true if the configuration was updated.
160     */
161    boolean updateConfiguration(in Configuration values);
162    boolean stopServiceToken(in ComponentName className, in IBinder token, int startId);
163    ComponentName getActivityClassForToken(in IBinder token);
164    String getPackageForToken(in IBinder token);
165    void setProcessLimit(int max);
166    int getProcessLimit();
167    int checkPermission(in String permission, int pid, int uid);
168    int checkUriPermission(in Uri uri, int pid, int uid, int mode, int userId,
169            in IBinder callerToken);
170    void grantUriPermission(in IApplicationThread caller, in String targetPkg, in Uri uri,
171            int mode, int userId);
172    void revokeUriPermission(in IApplicationThread caller, in String targetPkg, in Uri uri,
173            int mode, int userId);
174    void setActivityController(in IActivityController watcher, boolean imAMonkey);
175    void showWaitingForDebugger(in IApplicationThread who, boolean waiting);
176    /*
177     * This will deliver the specified signal to all the persistent processes. Currently only
178     * SIGUSR1 is delivered. All others are ignored.
179     */
180    void signalPersistentProcesses(int signal);
181    ParceledListSlice getRecentTasks(int maxNum,
182            int flags, int userId);
183    oneway void serviceDoneExecuting(in IBinder token, int type, int startId, int res);
184    oneway void activityDestroyed(in IBinder token);
185    IIntentSender getIntentSender(int type, in String packageName, in IBinder token,
186            in String resultWho, int requestCode, in Intent[] intents, in String[] resolvedTypes,
187            int flags, in Bundle options, int userId);
188    void cancelIntentSender(in IIntentSender sender);
189    String getPackageForIntentSender(in IIntentSender sender);
190    void registerIntentSenderCancelListener(in IIntentSender sender, in IResultReceiver receiver);
191    void unregisterIntentSenderCancelListener(in IIntentSender sender, in IResultReceiver receiver);
192    void enterSafeMode();
193    boolean startNextMatchingActivity(in IBinder callingActivity,
194            in Intent intent, in Bundle options);
195    void noteWakeupAlarm(in IIntentSender sender, int sourceUid,
196            in String sourcePkg, in String tag);
197    void removeContentProvider(in IBinder connection, boolean stable);
198    void setRequestedOrientation(in IBinder token, int requestedOrientation);
199    int getRequestedOrientation(in IBinder token);
200    void unbindFinished(in IBinder token, in Intent service, boolean doRebind);
201    void setProcessImportant(in IBinder token, int pid, boolean isForeground, String reason);
202    void setServiceForeground(in ComponentName className, in IBinder token,
203            int id, in Notification notification, int flags);
204    boolean moveActivityTaskToBack(in IBinder token, boolean nonRoot);
205    void getMemoryInfo(out ActivityManager.MemoryInfo outInfo);
206    List<ActivityManager.ProcessErrorStateInfo> getProcessesInErrorState();
207    boolean clearApplicationUserData(in String packageName,
208            in IPackageDataObserver observer, int userId);
209    void forceStopPackage(in String packageName, int userId);
210    boolean killPids(in int[] pids, in String reason, boolean secure);
211    List<ActivityManager.RunningServiceInfo> getServices(int maxNum, int flags);
212    ActivityManager.TaskThumbnail getTaskThumbnail(int taskId);
213    ActivityManager.TaskDescription getTaskDescription(int taskId);
214    // Retrieve running application processes in the system
215    List<ActivityManager.RunningAppProcessInfo> getRunningAppProcesses();
216    // Get device configuration
217    ConfigurationInfo getDeviceConfigurationInfo();
218    IBinder peekService(in Intent service, in String resolvedType, in String callingPackage);
219    // Turn on/off profiling in a particular process.
220    boolean profileControl(in String process, int userId, boolean start,
221            in ProfilerInfo profilerInfo, int profileType);
222    boolean shutdown(int timeout);
223    void stopAppSwitches();
224    void resumeAppSwitches();
225    boolean bindBackupAgent(in String packageName, int backupRestoreMode, int userId);
226    void backupAgentCreated(in String packageName, in IBinder agent);
227    void unbindBackupAgent(in ApplicationInfo appInfo);
228    int getUidForIntentSender(in IIntentSender sender);
229    int handleIncomingUser(int callingPid, int callingUid, int userId, boolean allowAll,
230            boolean requireFull, in String name, in String callerPackage);
231    void addPackageDependency(in String packageName);
232    void killApplication(in String pkg, int appId, int userId, in String reason);
233    void closeSystemDialogs(in String reason);
234    Debug.MemoryInfo[] getProcessMemoryInfo(in int[] pids);
235    void killApplicationProcess(in String processName, int uid);
236    int startActivityIntentSender(in IApplicationThread caller,
237            in IIntentSender target, in IBinder whitelistToken, in Intent fillInIntent,
238            in String resolvedType, in IBinder resultTo, in String resultWho, int requestCode,
239            int flagsMask, int flagsValues, in Bundle options);
240    void overridePendingTransition(in IBinder token, in String packageName,
241            int enterAnim, int exitAnim);
242    // Special low-level communication with activity manager.
243    boolean handleApplicationWtf(in IBinder app, in String tag, boolean system,
244            in ApplicationErrorReport.ParcelableCrashInfo crashInfo);
245    void killBackgroundProcesses(in String packageName, int userId);
246    boolean isUserAMonkey();
247    WaitResult startActivityAndWait(in IApplicationThread caller, in String callingPackage,
248            in Intent intent, in String resolvedType, in IBinder resultTo, in String resultWho,
249            int requestCode, int flags, in ProfilerInfo profilerInfo, in Bundle options,
250            int userId);
251    boolean willActivityBeVisible(in IBinder token);
252    int startActivityWithConfig(in IApplicationThread caller, in String callingPackage,
253            in Intent intent, in String resolvedType, in IBinder resultTo, in String resultWho,
254            int requestCode, int startFlags, in Configuration newConfig,
255            in Bundle options, int userId);
256    // Retrieve info of applications installed on external media that are currently
257    // running.
258    List<ApplicationInfo> getRunningExternalApplications();
259    void finishHeavyWeightApp();
260    // A StrictMode violation to be handled.  The violationMask is a
261    // subset of the original StrictMode policy bitmask, with only the
262    // bit violated and penalty bits to be executed by the
263    // ActivityManagerService remaining set.
264    void handleApplicationStrictModeViolation(in IBinder app, int violationMask,
265            in StrictMode.ViolationInfo crashInfo);
266    boolean isImmersive(in IBinder token);
267    void setImmersive(in IBinder token, boolean immersive);
268    boolean isTopActivityImmersive();
269    void crashApplication(int uid, int initialPid, in String packageName, int userId, in String message);
270    String getProviderMimeType(in Uri uri, int userId);
271    IBinder newUriPermissionOwner(in String name);
272    void grantUriPermissionFromOwner(in IBinder owner, int fromUid, in String targetPkg,
273            in Uri uri, int mode, int sourceUserId, int targetUserId);
274    void revokeUriPermissionFromOwner(in IBinder owner, in Uri uri, int mode, int userId);
275    int checkGrantUriPermission(int callingUid, in String targetPkg, in Uri uri,
276            int modeFlags, int userId);
277    // Cause the specified process to dump the specified heap.
278    boolean dumpHeap(in String process, int userId, boolean managed, boolean mallocInfo,
279            boolean runGc, in String path, in ParcelFileDescriptor fd);
280    int startActivities(in IApplicationThread caller, in String callingPackage,
281            in Intent[] intents, in String[] resolvedTypes, in IBinder resultTo,
282            in Bundle options, int userId);
283    boolean isUserRunning(int userid, int flags);
284    oneway void activitySlept(in IBinder token);
285    int getFrontActivityScreenCompatMode();
286    void setFrontActivityScreenCompatMode(int mode);
287    int getPackageScreenCompatMode(in String packageName);
288    void setPackageScreenCompatMode(in String packageName, int mode);
289    boolean getPackageAskScreenCompat(in String packageName);
290    void setPackageAskScreenCompat(in String packageName, boolean ask);
291    boolean switchUser(int userid);
292    void setFocusedTask(int taskId);
293    boolean removeTask(int taskId);
294    void registerProcessObserver(in IProcessObserver observer);
295    void unregisterProcessObserver(in IProcessObserver observer);
296    boolean isIntentSenderTargetedToPackage(in IIntentSender sender);
297    void updatePersistentConfiguration(in Configuration values);
298    long[] getProcessPss(in int[] pids);
299    void showBootMessage(in CharSequence msg, boolean always);
300    void killAllBackgroundProcesses();
301    ContentProviderHolder getContentProviderExternal(in String name, int userId,
302            in IBinder token);
303    void removeContentProviderExternal(in String name, in IBinder token);
304    // Get memory information about the calling process.
305    void getMyMemoryState(out ActivityManager.RunningAppProcessInfo outInfo);
306    boolean killProcessesBelowForeground(in String reason);
307    UserInfo getCurrentUser();
308    boolean shouldUpRecreateTask(in IBinder token, in String destAffinity);
309    boolean navigateUpTo(in IBinder token, in Intent target, int resultCode,
310            in Intent resultData);
311    void setLockScreenShown(boolean showing);
312    boolean finishActivityAffinity(in IBinder token);
313    // This is not public because you need to be very careful in how you
314    // manage your activity to make sure it is always the uid you expect.
315    int getLaunchedFromUid(in IBinder activityToken);
316    void unstableProviderDied(in IBinder connection);
317    boolean isIntentSenderAnActivity(in IIntentSender sender);
318    int startActivityAsUser(in IApplicationThread caller, in String callingPackage,
319            in Intent intent, in String resolvedType, in IBinder resultTo, in String resultWho,
320            int requestCode, int flags, in ProfilerInfo profilerInfo,
321            in Bundle options, int userId);
322    int stopUser(int userid, boolean force, in IStopUserCallback callback);
323    void registerUserSwitchObserver(in IUserSwitchObserver observer, in String name);
324    void unregisterUserSwitchObserver(in IUserSwitchObserver observer);
325    int[] getRunningUserIds();
326
327    // Deprecated - This method is only used by a few internal components and it will soon be
328    // replaced by a proper bug report API (which will be restricted to a few, pre-defined apps).
329    // No new code should be calling it.
330    void requestBugReport(int bugreportType);
331
332    /**
333     *  Takes a telephony bug report and notifies the user with the title and description
334     *  that are passed to this API as parameters
335     *
336     *  @param shareTitle should be a valid legible string less than 50 chars long
337     *  @param shareDescription should be less than 91 bytes when encoded into UTF-8 format
338     *
339     *  @throws IllegalArgumentException if shareTitle or shareDescription is too big or if the
340     *          paremeters cannot be encoding to an UTF-8 charset.
341     */
342    void requestTelephonyBugReport(in String shareTitle, in String shareDescription);
343
344    long inputDispatchingTimedOut(int pid, boolean aboveSystem, in String reason);
345    void clearPendingBackup();
346    Intent getIntentForIntentSender(in IIntentSender sender);
347    Bundle getAssistContextExtras(int requestType);
348    void reportAssistContextExtras(in IBinder token, in Bundle extras,
349            in AssistStructure structure, in AssistContent content, in Uri referrer);
350    // This is not public because you need to be very careful in how you
351    // manage your activity to make sure it is always the uid you expect.
352    String getLaunchedFromPackage(in IBinder activityToken);
353    void killUid(int appId, int userId, in String reason);
354    void setUserIsMonkey(boolean monkey);
355    void hang(in IBinder who, boolean allowRestart);
356    void moveTaskToStack(int taskId, int stackId, boolean toTop);
357    /**
358     * Resizes the input stack id to the given bounds.
359     *
360     * @param stackId Id of the stack to resize.
361     * @param bounds Bounds to resize the stack to or {@code null} for fullscreen.
362     * @param allowResizeInDockedMode True if the resize should be allowed when the docked stack is
363     *                                active.
364     * @param preserveWindows True if the windows of activities contained in the stack should be
365     *                        preserved.
366     * @param animate True if the stack resize should be animated.
367     * @param animationDuration The duration of the resize animation in milliseconds or -1 if the
368     *                          default animation duration should be used.
369     * @throws RemoteException
370     */
371    void resizeStack(int stackId, in Rect bounds, boolean allowResizeInDockedMode,
372            boolean preserveWindows, boolean animate, int animationDuration);
373    List<ActivityManager.StackInfo> getAllStackInfos();
374    void setFocusedStack(int stackId);
375    ActivityManager.StackInfo getStackInfo(int stackId);
376    boolean convertFromTranslucent(in IBinder token);
377    boolean convertToTranslucent(in IBinder token, in Bundle options);
378    void notifyActivityDrawn(in IBinder token);
379    void reportActivityFullyDrawn(in IBinder token, boolean restoredFromBundle);
380    void restart();
381    void performIdleMaintenance();
382    void takePersistableUriPermission(in Uri uri, int modeFlags, int userId);
383    void releasePersistableUriPermission(in Uri uri, int modeFlags, int userId);
384    ParceledListSlice getPersistedUriPermissions(in String packageName, boolean incoming);
385    void appNotRespondingViaProvider(in IBinder connection);
386    Rect getTaskBounds(int taskId);
387    int getActivityDisplayId(in IBinder activityToken);
388    boolean setProcessMemoryTrimLevel(in String process, int uid, int level);
389
390
391    // Start of L transactions
392    String getTagForIntentSender(in IIntentSender sender, in String prefix);
393    boolean startUserInBackground(int userid);
394    void startLockTaskModeById(int taskId);
395    void startLockTaskModeByToken(in IBinder token);
396    void stopLockTaskMode();
397    boolean isInLockTaskMode();
398    void setTaskDescription(in IBinder token, in ActivityManager.TaskDescription values);
399    int startVoiceActivity(in String callingPackage, int callingPid, int callingUid,
400            in Intent intent, in String resolvedType, in IVoiceInteractionSession session,
401            in IVoiceInteractor interactor, int flags, in ProfilerInfo profilerInfo,
402            in Bundle options, int userId);
403    int startAssistantActivity(in String callingPackage, int callingPid, int callingUid,
404            in Intent intent, in String resolvedType, in Bundle options, int userId);
405    Bundle getActivityOptions(in IBinder token);
406    List<IBinder> getAppTasks(in String callingPackage);
407    void startSystemLockTaskMode(int taskId);
408    void stopSystemLockTaskMode();
409    void finishVoiceTask(in IVoiceInteractionSession session);
410    boolean isTopOfTask(in IBinder token);
411    void notifyLaunchTaskBehindComplete(in IBinder token);
412    int startActivityFromRecents(int taskId, in Bundle options);
413    void notifyEnterAnimationComplete(in IBinder token);
414    int startActivityAsCaller(in IApplicationThread caller, in String callingPackage,
415            in Intent intent, in String resolvedType, in IBinder resultTo, in String resultWho,
416            int requestCode, int flags, in ProfilerInfo profilerInfo, in Bundle options,
417            boolean ignoreTargetSecurity, int userId);
418    int addAppTask(in IBinder activityToken, in Intent intent,
419            in ActivityManager.TaskDescription description, in Bitmap thumbnail);
420    Point getAppTaskThumbnailSize();
421    boolean releaseActivityInstance(in IBinder token);
422    void releaseSomeActivities(in IApplicationThread app);
423    void bootAnimationComplete();
424    Bitmap getTaskDescriptionIcon(in String filename, int userId);
425    boolean launchAssistIntent(in Intent intent, int requestType, in String hint, int userHandle,
426            in Bundle args);
427    void startInPlaceAnimationOnFrontMostApplication(in Bundle opts);
428    int checkPermissionWithToken(in String permission, int pid, int uid,
429            in IBinder callerToken);
430    void registerTaskStackListener(in ITaskStackListener listener);
431
432
433    // Start of M transactions
434    void notifyCleartextNetwork(int uid, in byte[] firstPacket);
435    int createStackOnDisplay(int displayId);
436    int getFocusedStackId();
437    void setTaskResizeable(int taskId, int resizeableMode);
438    boolean requestAssistContextExtras(int requestType, in IResultReceiver receiver,
439            in Bundle receiverExtras, in IBinder activityToken,
440            boolean focused, boolean newSessionId);
441    void resizeTask(int taskId, in Rect bounds, int resizeMode);
442    int getLockTaskModeState();
443    void setDumpHeapDebugLimit(in String processName, int uid, long maxMemSize,
444            in String reportPackage);
445    void dumpHeapFinished(in String path);
446    void setVoiceKeepAwake(in IVoiceInteractionSession session, boolean keepAwake);
447    void updateLockTaskPackages(int userId, in String[] packages);
448    void noteAlarmStart(in IIntentSender sender, int sourceUid, in String tag);
449    void noteAlarmFinish(in IIntentSender sender, int sourceUid, in String tag);
450    int getPackageProcessState(in String packageName, in String callingPackage);
451    oneway void showLockTaskEscapeMessage(in IBinder token);
452    void updateDeviceOwner(in String packageName);
453    /**
454     * Notify the system that the keyguard is going away.
455     *
456     * @param flags See {@link android.view.WindowManagerPolicy#KEYGUARD_GOING_AWAY_FLAG_TO_SHADE}
457     *              etc.
458     */
459    void keyguardGoingAway(int flags);
460    int getUidProcessState(int uid, in String callingPackage);
461    void registerUidObserver(in IUidObserver observer, int which, int cutpoint,
462            String callingPackage);
463    void unregisterUidObserver(in IUidObserver observer);
464    boolean isAssistDataAllowedOnCurrentActivity();
465    boolean showAssistFromActivity(in IBinder token, in Bundle args);
466    boolean isRootVoiceInteraction(in IBinder token);
467
468
469    // Start of N transactions
470    // Start Binder transaction tracking for all applications.
471    boolean startBinderTracking();
472    // Stop Binder transaction tracking for all applications and dump trace data to the given file
473    // descriptor.
474    boolean stopBinderTrackingAndDump(in ParcelFileDescriptor fd);
475    /**
476     * Try to place task to provided position. The final position might be different depending on
477     * current user and stacks state. The task will be moved to target stack if it's currently in
478     * different stack.
479     */
480    void positionTaskInStack(int taskId, int stackId, int position);
481    int getActivityStackId(in IBinder token);
482    void exitFreeformMode(in IBinder token);
483    void reportSizeConfigurations(in IBinder token, in int[] horizontalSizeConfiguration,
484            in int[] verticalSizeConfigurations, in int[] smallestWidthConfigurations);
485    boolean moveTaskToDockedStack(int taskId, int createMode, boolean toTop, boolean animate,
486            in Rect initialBounds);
487    void suppressResizeConfigChanges(boolean suppress);
488    void moveTasksToFullscreenStack(int fromStackId, boolean onTop);
489    boolean moveTopActivityToPinnedStack(int stackId, in Rect bounds);
490    boolean isAppStartModeDisabled(int uid, in String packageName);
491    boolean unlockUser(int userid, in byte[] token, in byte[] secret,
492            in IProgressListener listener);
493    boolean isInMultiWindowMode(in IBinder token);
494    boolean isInPictureInPictureMode(in IBinder token);
495    void killPackageDependents(in String packageName, int userId);
496    boolean enterPictureInPictureMode(in IBinder token, in PictureInPictureParams params);
497    void setPictureInPictureParams(in IBinder token, in PictureInPictureParams params);
498    int getMaxNumPictureInPictureActions(in IBinder token);
499    void activityRelaunched(in IBinder token);
500    IBinder getUriPermissionOwnerForActivity(in IBinder activityToken);
501    /**
502     * Resizes the docked stack, and all other stacks as the result of the dock stack bounds change.
503     *
504     * @param dockedBounds The bounds for the docked stack.
505     * @param tempDockedTaskBounds The temporary bounds for the tasks in the docked stack, which
506     *                             might be different from the stack bounds to allow more
507     *                             flexibility while resizing, or {@code null} if they should be the
508     *                             same as the stack bounds.
509     * @param tempDockedTaskInsetBounds The temporary bounds for the tasks to calculate the insets.
510     *                                  When resizing, we usually "freeze" the layout of a task. To
511     *                                  achieve that, we also need to "freeze" the insets, which
512     *                                  gets achieved by changing task bounds but not bounds used
513     *                                  to calculate the insets in this transient state
514     * @param tempOtherTaskBounds The temporary bounds for the tasks in all other stacks, or
515     *                            {@code null} if they should be the same as the stack bounds.
516     * @param tempOtherTaskInsetBounds Like {@code tempDockedTaskInsetBounds}, but for the other
517     *                                 stacks.
518     * @throws RemoteException
519     */
520    void resizeDockedStack(in Rect dockedBounds, in Rect tempDockedTaskBounds,
521            in Rect tempDockedTaskInsetBounds,
522            in Rect tempOtherTaskBounds, in Rect tempOtherTaskInsetBounds);
523    int setVrMode(in IBinder token, boolean enabled, in ComponentName packageName);
524    // Gets the URI permissions granted to an arbitrary package.
525    // NOTE: this is different from getPersistedUriPermissions(), which returns the URIs the package
526    // granted to another packages (instead of those granted to it).
527    ParceledListSlice getGrantedUriPermissions(in String packageName, int userId);
528    // Clears the URI permissions granted to an arbitrary package.
529    void clearGrantedUriPermissions(in String packageName, int userId);
530    boolean isAppForeground(int uid);
531    void startLocalVoiceInteraction(in IBinder token, in Bundle options);
532    void stopLocalVoiceInteraction(in IBinder token);
533    boolean supportsLocalVoiceInteraction();
534    void notifyPinnedStackAnimationStarted();
535    void notifyPinnedStackAnimationEnded();
536    void removeStack(int stackId);
537    void makePackageIdle(String packageName, int userId);
538    int getMemoryTrimLevel();
539    /**
540     * Resizes the pinned stack.
541     *
542     * @param pinnedBounds The bounds for the pinned stack.
543     * @param tempPinnedTaskBounds The temporary bounds for the tasks in the pinned stack, which
544     *                             might be different from the stack bounds to allow more
545     *                             flexibility while resizing, or {@code null} if they should be the
546     *                             same as the stack bounds.
547     */
548    void resizePinnedStack(in Rect pinnedBounds, in Rect tempPinnedTaskBounds);
549    boolean isVrModePackageEnabled(in ComponentName packageName);
550    /**
551     * Moves all tasks from the docked stack in the fullscreen stack and puts the top task of the
552     * fullscreen stack into the docked stack.
553     */
554    void swapDockedAndFullscreenStack();
555    void notifyLockedProfile(int userId);
556    void startConfirmDeviceCredentialIntent(in Intent intent, in Bundle options);
557    void sendIdleJobTrigger();
558    int sendIntentSender(in IIntentSender target, in IBinder whitelistToken, int code,
559            in Intent intent, in String resolvedType, in IIntentReceiver finishedReceiver,
560            in String requiredPermission, in Bundle options);
561
562
563    // Start of N MR1 transactions
564    void setVrThread(int tid);
565    void setRenderThread(int tid);
566    /**
567     * Lets activity manager know whether the calling process is currently showing "top-level" UI
568     * that is not an activity, i.e. windows on the screen the user is currently interacting with.
569     *
570     * <p>This flag can only be set for persistent processes.
571     *
572     * @param hasTopUi Whether the calling process has "top-level" UI.
573     */
574    void setHasTopUi(boolean hasTopUi);
575
576    // Start of O transactions
577    void requestActivityRelaunch(in IBinder token);
578    /**
579     * Updates override configuration applied to specific display.
580     * @param values Update values for display configuration. If null is passed it will request the
581     *               Window Manager to compute new config for the specified display.
582     * @param displayId Id of the display to apply the config to.
583     * @throws RemoteException
584     * @return Returns true if the configuration was updated.
585     */
586    boolean updateDisplayOverrideConfiguration(in Configuration values, int displayId);
587    void unregisterTaskStackListener(ITaskStackListener listener);
588    void moveStackToDisplay(int stackId, int displayId);
589    boolean requestAutofillData(in IResultReceiver receiver, in Bundle receiverExtras,
590                                in IBinder activityToken, int flags);
591    void dismissKeyguard(in IBinder token, in IKeyguardDismissCallback callback);
592    int restartUserInBackground(int userId);
593
594    /** Cancels the window transitions for the given task. */
595    void cancelTaskWindowTransition(int taskId);
596
597    /** Cancels the thumbnail transitions for the given task. */
598    void cancelTaskThumbnailTransition(int taskId);
599
600    /**
601     * @param taskId the id of the task to retrieve the sAutoapshots for
602     * @param reducedResolution if set, if the snapshot needs to be loaded from disk, this will load
603     *                          a reduced resolution of it, which is much faster
604     * @return a graphic buffer representing a screenshot of a task
605     */
606    ActivityManager.TaskSnapshot getTaskSnapshot(int taskId, boolean reducedResolution);
607
608    void scheduleApplicationInfoChanged(in List<String> packageNames, int userId);
609    void setPersistentVrThread(int tid);
610
611    void waitForNetworkStateUpdate(long procStateSeq);
612
613    /**
614     * See {@link android.app.Activity#setDisablePreviewScreenshots}
615     */
616    void setDisablePreviewScreenshots(IBinder token, boolean disable);
617
618    /**
619     * Return the user id of last resumed activity.
620     */
621    int getLastResumedActivityUserId();
622
623    /**
624     * Add a bare uid to the background restrictions whitelist.  Only the system uid may call this.
625     */
626     void backgroundWhitelistUid(int uid);
627
628    // WARNING: when these transactions are updated, check if they are any callers on the native
629    // side. If so, make sure they are using the correct transaction ids and arguments.
630    // If a transaction which will also be used on the native side is being inserted, add it
631    // alongside with other transactions of this kind at the top of this file.
632
633     void setShowWhenLocked(in IBinder token, boolean showWhenLocked);
634     void setTurnScreenOn(in IBinder token, boolean turnScreenOn);
635}
636