IActivityManager.aidl revision 08992ac57e973d6bf32693725ebb341a481e5944
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.IActivityContainer;
24import android.app.IActivityContainerCallback;
25import android.app.IActivityController;
26import android.app.IAppTask;
27import android.app.IInstrumentationWatcher;
28import android.app.IProcessObserver;
29import android.app.IServiceConnection;
30import android.app.IStopUserCallback;
31import android.app.ITaskStackListener;
32import android.app.IUiAutomationConnection;
33import android.app.IUidObserver;
34import android.app.IUserSwitchObserver;
35import android.app.Notification;
36import android.app.PendingIntent;
37import android.app.PictureInPictureArgs;
38import android.app.ProfilerInfo;
39import android.app.WaitResult;
40import android.app.assist.AssistContent;
41import android.app.assist.AssistStructure;
42import android.content.ComponentName;
43import android.content.IIntentReceiver;
44import android.content.IIntentSender;
45import android.content.Intent;
46import android.content.IntentFilter;
47import android.content.IntentSender;
48import android.content.pm.ApplicationInfo;
49import android.content.pm.ConfigurationInfo;
50import android.content.pm.IPackageDataObserver;
51import android.content.pm.ParceledListSlice;
52import android.content.pm.ProviderInfo;
53import android.content.pm.UserInfo;
54import android.content.res.Configuration;
55import android.graphics.Bitmap;
56import android.graphics.GraphicBuffer;
57import android.graphics.Point;
58import android.graphics.Rect;
59import android.net.Uri;
60import android.os.Bundle;
61import android.os.Debug;
62import android.os.IBinder;
63import android.os.IProgressListener;
64import android.os.ParcelFileDescriptor;
65import android.os.PersistableBundle;
66import android.os.StrictMode;
67import android.service.voice.IVoiceInteractionSession;
68import com.android.internal.app.IVoiceInteractor;
69import com.android.internal.os.IResultReceiver;
70import com.android.internal.policy.IKeyguardDismissCallback;
71
72import java.util.List;
73
74/**
75 * System private API for talking with the activity manager service.  This
76 * provides calls from the application back to the activity manager.
77 *
78 * {@hide}
79 */
80interface IActivityManager {
81    // WARNING: when these transactions are updated, check if they are any callers on the native
82    // side. If so, make sure they are using the correct transaction ids and arguments.
83    // If a transaction which will also be used on the native side is being inserted, add it to
84    // below block of transactions.
85
86    // Since these transactions are also called from native code, these must be kept in sync with
87    // the ones in frameworks/native/include/binder/IActivityManager.h
88    // =============== Beginning of transactions used on native side as well ======================
89    ParcelFileDescriptor openContentUri(in String uriString);
90    // =============== End of transactions used on native side as well ============================
91
92    // Special low-level communication with activity manager.
93    void handleApplicationCrash(in IBinder app,
94            in ApplicationErrorReport.ParcelableCrashInfo crashInfo);
95    int startActivity(in IApplicationThread caller, in String callingPackage, in Intent intent,
96            in String resolvedType, in IBinder resultTo, in String resultWho, int requestCode,
97            int flags, in ProfilerInfo profilerInfo, in Bundle options);
98    void unhandledBack();
99
100    boolean finishActivity(in IBinder token, int code, in Intent data, int finishTask);
101    Intent registerReceiver(in IApplicationThread caller, in String callerPackage,
102            in IIntentReceiver receiver, in IntentFilter filter,
103            in String requiredPermission, int userId, boolean visibleToInstantApps);
104    void unregisterReceiver(in IIntentReceiver receiver);
105    int broadcastIntent(in IApplicationThread caller, in Intent intent,
106            in String resolvedType, in IIntentReceiver resultTo, int resultCode,
107            in String resultData, in Bundle map, in String[] requiredPermissions,
108            int appOp, in Bundle options, boolean serialized, boolean sticky, int userId);
109    void unbroadcastIntent(in IApplicationThread caller, in Intent intent, int userId);
110    oneway void finishReceiver(in IBinder who, int resultCode, in String resultData, in Bundle map,
111            boolean abortBroadcast, int flags);
112    void attachApplication(in IApplicationThread app);
113    oneway void activityIdle(in IBinder token, in Configuration config,
114            in boolean stopProfiling);
115    void activityPaused(in IBinder token);
116    oneway void activityStopped(in IBinder token, in Bundle state,
117            in PersistableBundle persistentState, in CharSequence description);
118    String getCallingPackage(in IBinder token);
119    ComponentName getCallingActivity(in IBinder token);
120    List<ActivityManager.RunningTaskInfo> getTasks(int maxNum, int flags);
121    void moveTaskToFront(int task, int flags, in Bundle options);
122    void moveTaskBackwards(int task);
123    int getTaskForActivity(in IBinder token, in boolean onlyRoot);
124    ContentProviderHolder getContentProvider(in IApplicationThread caller,
125            in String name, int userId, boolean stable);
126    void publishContentProviders(in IApplicationThread caller,
127            in List<ContentProviderHolder> providers);
128    boolean refContentProvider(in IBinder connection, int stableDelta, int unstableDelta);
129    void finishSubActivity(in IBinder token, in String resultWho, int requestCode);
130    PendingIntent getRunningServiceControlPanel(in ComponentName service);
131    ComponentName startService(in IApplicationThread caller, in Intent service,
132            in String resolvedType, int id, in Notification notification,
133            boolean requireForeground, in String callingPackage, int userId);
134    int stopService(in IApplicationThread caller, in Intent service,
135            in String resolvedType, int userId);
136    int bindService(in IApplicationThread caller, in IBinder token, in Intent service,
137            in String resolvedType, in IServiceConnection connection, int flags,
138            in String callingPackage, int userId);
139    boolean unbindService(in IServiceConnection connection);
140    void publishService(in IBinder token, in Intent intent, in IBinder service);
141    void activityResumed(in IBinder token);
142    void setDebugApp(in String packageName, boolean waitForDebugger, boolean persistent);
143    void setAlwaysFinish(boolean enabled);
144    boolean startInstrumentation(in ComponentName className, in String profileFile,
145            int flags, in Bundle arguments, in IInstrumentationWatcher watcher,
146            in IUiAutomationConnection connection, int userId,
147            in String abiOverride);
148    void addInstrumentationResults(in IApplicationThread target, in Bundle results);
149    void finishInstrumentation(in IApplicationThread target, int resultCode,
150            in Bundle results);
151    /**
152     * @return A copy of global {@link Configuration}, contains general settings for the entire
153     *         system. Corresponds to the configuration of the default display.
154     * @throws RemoteException
155     */
156    Configuration getConfiguration();
157    /**
158     * Updates global configuration and applies changes to the entire system.
159     * @param values Update values for global configuration. If null is passed it will request the
160     *               Window Manager to compute new config for the default display.
161     * @throws RemoteException
162     * @return Returns true if the configuration was updated.
163     */
164    boolean updateConfiguration(in Configuration values);
165    boolean stopServiceToken(in ComponentName className, in IBinder token, int startId);
166    ComponentName getActivityClassForToken(in IBinder token);
167    String getPackageForToken(in IBinder token);
168    void setProcessLimit(int max);
169    int getProcessLimit();
170    int checkPermission(in String permission, int pid, int uid);
171    int checkUriPermission(in Uri uri, int pid, int uid, int mode, int userId,
172            in IBinder callerToken);
173    void grantUriPermission(in IApplicationThread caller, in String targetPkg, in Uri uri,
174            int mode, int userId);
175    void revokeUriPermission(in IApplicationThread caller, in Uri uri, int mode, int userId);
176    void setActivityController(in IActivityController watcher, boolean imAMonkey);
177    void showWaitingForDebugger(in IApplicationThread who, boolean waiting);
178    /*
179     * This will deliver the specified signal to all the persistent processes. Currently only
180     * SIGUSR1 is delivered. All others are ignored.
181     */
182    void signalPersistentProcesses(int signal);
183    ParceledListSlice getRecentTasks(int maxNum,
184            int flags, int userId);
185    oneway void serviceDoneExecuting(in IBinder token, int type, int startId, int res);
186    oneway void activityDestroyed(in IBinder token);
187    IIntentSender getIntentSender(int type, in String packageName, in IBinder token,
188            in String resultWho, int requestCode, in Intent[] intents, in String[] resolvedTypes,
189            int flags, in Bundle options, int userId);
190    void cancelIntentSender(in IIntentSender sender);
191    String getPackageForIntentSender(in IIntentSender sender);
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 setProcessForeground(in IBinder token, int pid, boolean isForeground);
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 IntentSender intent, in Intent fillInIntent, in String resolvedType,
238            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, in String path,
279            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    IActivityContainer createVirtualActivityContainer(in IBinder parentActivityToken,
357            in IActivityContainerCallback callback);
358    void moveTaskToStack(int taskId, int stackId, boolean toTop);
359    /**
360     * Resizes the input stack id to the given bounds.
361     *
362     * @param stackId Id of the stack to resize.
363     * @param bounds Bounds to resize the stack to or {@code null} for fullscreen.
364     * @param allowResizeInDockedMode True if the resize should be allowed when the docked stack is
365     *                                active.
366     * @param preserveWindows True if the windows of activities contained in the stack should be
367     *                        preserved.
368     * @param animate True if the stack resize should be animated.
369     * @param animationDuration The duration of the resize animation in milliseconds or -1 if the
370     *                          default animation duration should be used.
371     * @throws RemoteException
372     */
373    void resizeStack(int stackId, in Rect bounds, boolean allowResizeInDockedMode,
374            boolean preserveWindows, boolean animate, int animationDuration);
375    List<ActivityManager.StackInfo> getAllStackInfos();
376    void setFocusedStack(int stackId);
377    ActivityManager.StackInfo getStackInfo(int stackId);
378    boolean convertFromTranslucent(in IBinder token);
379    boolean convertToTranslucent(in IBinder token, in Bundle options);
380    void notifyActivityDrawn(in IBinder token);
381    void reportActivityFullyDrawn(in IBinder token);
382    void restart();
383    void performIdleMaintenance();
384    void takePersistableUriPermission(in Uri uri, int modeFlags, int userId);
385    void releasePersistableUriPermission(in Uri uri, int modeFlags, int userId);
386    ParceledListSlice getPersistedUriPermissions(in String packageName, boolean incoming);
387    void appNotRespondingViaProvider(in IBinder connection);
388    Rect getTaskBounds(int taskId);
389    int getActivityDisplayId(in IBinder activityToken);
390    boolean setProcessMemoryTrimLevel(in String process, int uid, int level);
391
392
393    // Start of L transactions
394    String getTagForIntentSender(in IIntentSender sender, in String prefix);
395    boolean startUserInBackground(int userid);
396    void startLockTaskModeById(int taskId);
397    void startLockTaskModeByToken(in IBinder token);
398    void stopLockTaskMode();
399    boolean isInLockTaskMode();
400    void setTaskDescription(in IBinder token, in ActivityManager.TaskDescription values);
401    int startVoiceActivity(in String callingPackage, int callingPid, int callingUid,
402            in Intent intent, in String resolvedType, in IVoiceInteractionSession session,
403            in IVoiceInteractor interactor, int flags, in ProfilerInfo profilerInfo,
404            in Bundle options, int userId);
405    int startAssistantActivity(in String callingPackage, int callingPid, int callingUid,
406            in Intent intent, in String resolvedType, in Bundle options, int userId);
407    Bundle getActivityOptions(in IBinder token);
408    List<IBinder> getAppTasks(in String callingPackage);
409    void startSystemLockTaskMode(int taskId);
410    void stopSystemLockTaskMode();
411    void finishVoiceTask(in IVoiceInteractionSession session);
412    boolean isTopOfTask(in IBinder token);
413    boolean requestVisibleBehind(in IBinder token, boolean visible);
414    boolean isBackgroundVisibleBehind(in IBinder token);
415    void backgroundResourcesReleased(in IBinder token);
416    void notifyLaunchTaskBehindComplete(in IBinder token);
417    int startActivityFromRecents(int taskId, in Bundle options);
418    void notifyEnterAnimationComplete(in IBinder token);
419    int startActivityAsCaller(in IApplicationThread caller, in String callingPackage,
420            in Intent intent, in String resolvedType, in IBinder resultTo, in String resultWho,
421            int requestCode, int flags, in ProfilerInfo profilerInfo, in Bundle options,
422            boolean ignoreTargetSecurity, int userId);
423    int addAppTask(in IBinder activityToken, in Intent intent,
424            in ActivityManager.TaskDescription description, in Bitmap thumbnail);
425    Point getAppTaskThumbnailSize();
426    boolean releaseActivityInstance(in IBinder token);
427    void releaseSomeActivities(in IApplicationThread app);
428    void bootAnimationComplete();
429    Bitmap getTaskDescriptionIcon(in String filename, int userId);
430    boolean launchAssistIntent(in Intent intent, int requestType, in String hint, int userHandle,
431            in Bundle args);
432    void startInPlaceAnimationOnFrontMostApplication(in Bundle opts);
433    int checkPermissionWithToken(in String permission, int pid, int uid,
434            in IBinder callerToken);
435    void registerTaskStackListener(in ITaskStackListener listener);
436
437
438    // Start of M transactions
439    void notifyCleartextNetwork(int uid, in byte[] firstPacket);
440    IActivityContainer createStackOnDisplay(int displayId);
441    int getFocusedStackId();
442    void setTaskResizeable(int taskId, int resizeableMode);
443    boolean requestAssistContextExtras(int requestType, in IResultReceiver receiver,
444            in Bundle receiverExtras, in IBinder activityToken,
445            boolean focused, boolean newSessionId);
446    void resizeTask(int taskId, in Rect bounds, int resizeMode);
447    int getLockTaskModeState();
448    void setDumpHeapDebugLimit(in String processName, int uid, long maxMemSize,
449            in String reportPackage);
450    void dumpHeapFinished(in String path);
451    void setVoiceKeepAwake(in IVoiceInteractionSession session, boolean keepAwake);
452    void updateLockTaskPackages(int userId, in String[] packages);
453    void noteAlarmStart(in IIntentSender sender, int sourceUid, in String tag);
454    void noteAlarmFinish(in IIntentSender sender, int sourceUid, in String tag);
455    int getPackageProcessState(in String packageName, in String callingPackage);
456    oneway void showLockTaskEscapeMessage(in IBinder token);
457    void updateDeviceOwner(in String packageName);
458    /**
459     * Notify the system that the keyguard is going away.
460     *
461     * @param flags See {@link android.view.WindowManagerPolicy#KEYGUARD_GOING_AWAY_FLAG_TO_SHADE}
462     *              etc.
463     */
464    void keyguardGoingAway(int flags);
465    void registerUidObserver(in IUidObserver observer, int which, int cutpoint,
466            String callingPackage);
467    void unregisterUidObserver(in IUidObserver observer);
468    boolean isAssistDataAllowedOnCurrentActivity();
469    boolean showAssistFromActivity(in IBinder token, in Bundle args);
470    boolean isRootVoiceInteraction(in IBinder token);
471
472
473    // Start of N transactions
474    // Start Binder transaction tracking for all applications.
475    boolean startBinderTracking();
476    // Stop Binder transaction tracking for all applications and dump trace data to the given file
477    // descriptor.
478    boolean stopBinderTrackingAndDump(in ParcelFileDescriptor fd);
479    /**
480     * Try to place task to provided position. The final position might be different depending on
481     * current user and stacks state. The task will be moved to target stack if it's currently in
482     * different stack.
483     */
484    void positionTaskInStack(int taskId, int stackId, int position);
485    int getActivityStackId(in IBinder token);
486    void exitFreeformMode(in IBinder token);
487    void reportSizeConfigurations(in IBinder token, in int[] horizontalSizeConfiguration,
488            in int[] verticalSizeConfigurations, in int[] smallestWidthConfigurations);
489    boolean moveTaskToDockedStack(int taskId, int createMode, boolean toTop, boolean animate,
490            in Rect initialBounds);
491    void suppressResizeConfigChanges(boolean suppress);
492    void moveTasksToFullscreenStack(int fromStackId, boolean onTop);
493    boolean moveTopActivityToPinnedStack(int stackId, in Rect bounds);
494    boolean isAppStartModeDisabled(int uid, in String packageName);
495    boolean unlockUser(int userid, in byte[] token, in byte[] secret,
496            in IProgressListener listener);
497    boolean isInMultiWindowMode(in IBinder token);
498    boolean isInPictureInPictureMode(in IBinder token);
499    void killPackageDependents(in String packageName, int userId);
500    boolean enterPictureInPictureMode(in IBinder token, in PictureInPictureArgs args);
501    void setPictureInPictureArgs(in IBinder token, in PictureInPictureArgs args);
502    void activityRelaunched(in IBinder token);
503    IBinder getUriPermissionOwnerForActivity(in IBinder activityToken);
504    /**
505     * Resizes the docked stack, and all other stacks as the result of the dock stack bounds change.
506     *
507     * @param dockedBounds The bounds for the docked stack.
508     * @param tempDockedTaskBounds The temporary bounds for the tasks in the docked stack, which
509     *                             might be different from the stack bounds to allow more
510     *                             flexibility while resizing, or {@code null} if they should be the
511     *                             same as the stack bounds.
512     * @param tempDockedTaskInsetBounds The temporary bounds for the tasks to calculate the insets.
513     *                                  When resizing, we usually "freeze" the layout of a task. To
514     *                                  achieve that, we also need to "freeze" the insets, which
515     *                                  gets achieved by changing task bounds but not bounds used
516     *                                  to calculate the insets in this transient state
517     * @param tempOtherTaskBounds The temporary bounds for the tasks in all other stacks, or
518     *                            {@code null} if they should be the same as the stack bounds.
519     * @param tempOtherTaskInsetBounds Like {@code tempDockedTaskInsetBounds}, but for the other
520     *                                 stacks.
521     * @throws RemoteException
522     */
523    void resizeDockedStack(in Rect dockedBounds, in Rect tempDockedTaskBounds,
524            in Rect tempDockedTaskInsetBounds,
525            in Rect tempOtherTaskBounds, in Rect tempOtherTaskInsetBounds);
526    int setVrMode(in IBinder token, boolean enabled, in ComponentName packageName);
527    // Gets the URI permissions granted to an arbitrary package.
528    // NOTE: this is different from getPersistedUriPermissions(), which returns the URIs the package
529    // granted to another packages (instead of those granted to it).
530    ParceledListSlice getGrantedUriPermissions(in String packageName, int userId);
531    // Clears the URI permissions granted to an arbitrary package.
532    void clearGrantedUriPermissions(in String packageName, int userId);
533    boolean isAppForeground(int uid);
534    void startLocalVoiceInteraction(in IBinder token, in Bundle options);
535    void stopLocalVoiceInteraction(in IBinder token);
536    boolean supportsLocalVoiceInteraction();
537    void notifyPinnedStackAnimationStarted();
538    void notifyPinnedStackAnimationEnded();
539    void removeStack(int stackId);
540    void makePackageIdle(String packageName, int userId);
541    int getMemoryTrimLevel();
542    /**
543     * Resizes the pinned stack.
544     *
545     * @param pinnedBounds The bounds for the pinned stack.
546     * @param tempPinnedTaskBounds The temporary bounds for the tasks in the pinned stack, which
547     *                             might be different from the stack bounds to allow more
548     *                             flexibility while resizing, or {@code null} if they should be the
549     *                             same as the stack bounds.
550     */
551    void resizePinnedStack(in Rect pinnedBounds, in Rect tempPinnedTaskBounds);
552    boolean isVrModePackageEnabled(in ComponentName packageName);
553    /**
554     * Moves all tasks from the docked stack in the fullscreen stack and puts the top task of the
555     * fullscreen stack into the docked stack.
556     */
557    void swapDockedAndFullscreenStack();
558    void notifyLockedProfile(int userId);
559    void startConfirmDeviceCredentialIntent(in Intent intent, in Bundle options);
560    void sendIdleJobTrigger();
561    int sendIntentSender(in IIntentSender target, int code, in Intent intent,
562            in String resolvedType, in IIntentReceiver finishedReceiver,
563            in String requiredPermission, in Bundle options);
564
565
566    // Start of N MR1 transactions
567    void setVrThread(int tid);
568    void setRenderThread(int tid);
569    /**
570     * Lets activity manager know whether the calling process is currently showing "top-level" UI
571     * that is not an activity, i.e. windows on the screen the user is currently interacting with.
572     *
573     * <p>This flag can only be set for persistent processes.
574     *
575     * @param hasTopUi Whether the calling process has "top-level" UI.
576     */
577    void setHasTopUi(boolean hasTopUi);
578    /**
579     * Returns if the target of the PendingIntent can be fired directly, without triggering
580     * a work profile challenge. This can happen if the PendingIntent is to start direct-boot
581     * aware activities, and the target user is in RUNNING_LOCKED state, i.e. we should allow
582     * direct-boot aware activity to bypass work challenge when the user hasn't unlocked yet.
583     * @param intent the {@link  PendingIntent} to be tested.
584     * @return {@code true} if the intent should not trigger a work challenge, {@code false}
585     *     otherwise.
586     * @throws RemoteException
587     */
588    boolean canBypassWorkChallenge(in PendingIntent intent);
589
590    // Start of O transactions
591    void requestActivityRelaunch(in IBinder token);
592    /**
593     * Updates override configuration applied to specific display.
594     * @param values Update values for display configuration. If null is passed it will request the
595     *               Window Manager to compute new config for the specified display.
596     * @param displayId Id of the display to apply the config to.
597     * @throws RemoteException
598     * @return Returns true if the configuration was updated.
599     */
600    boolean updateDisplayOverrideConfiguration(in Configuration values, int displayId);
601    void unregisterTaskStackListener(ITaskStackListener listener);
602    void moveStackToDisplay(int stackId, int displayId);
603    boolean requestAutofillData(in IResultReceiver receiver, in Bundle receiverExtras,
604                                in IBinder activityToken);
605    void dismissKeyguard(in IBinder token, in IKeyguardDismissCallback callback);
606    int restartUserInBackground(int userId);
607
608    /** Cancels the window transitions for the given task. */
609    void cancelTaskWindowTransition(int taskId);
610
611    /** Cancels the thumbnail transitions for the given task. */
612    void cancelTaskThumbnailTransition(int taskId);
613
614    /**
615     * @param taskId the id of the task to retrieve the snapshots for
616     * @param reducedResolution if set, if the snapshot needs to be loaded from disk, this will load
617     *                          a reduced resolution of it, which is much faster
618     * @return a graphic buffer representing a screenshot of a task
619     */
620    ActivityManager.TaskSnapshot getTaskSnapshot(int taskId, boolean reducedResolution);
621
622    void scheduleApplicationInfoChanged(in List<String> packageNames, int userId);
623    void setPersistentVrThread(int tid);
624
625    void waitForNetworkStateUpdate(long procStateSeq);
626
627    /**
628     * See {@link android.app.Activity#setDisablePreviewScreenshots}
629     */
630    void setDisablePreviewScreenshots(IBinder token, boolean disable);
631
632    /**
633     * Return the user id of last resumed activity.
634     */
635    int getLastResumedActivityUserId();
636
637    // WARNING: when these transactions are updated, check if they are any callers on the native
638    // side. If so, make sure they are using the correct transaction ids and arguments.
639    // If a transaction which will also be used on the native side is being inserted, add it
640    // alongside with other transactions of this kind at the top of this file.
641}
642