| /* |
| * Copyright (C) 2016 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License |
| */ |
| package android.os; |
| |
| import android.annotation.NonNull; |
| import android.annotation.Nullable; |
| import android.content.pm.UserInfo; |
| import android.graphics.Bitmap; |
| |
| /** |
| * @hide Only for use within the system server. |
| */ |
| public abstract class UserManagerInternal { |
| public interface UserRestrictionsListener { |
| /** |
| * Called when a user restriction changes. |
| * |
| * @param userId target user id |
| * @param newRestrictions new user restrictions |
| * @param prevRestrictions user restrictions that were previously set |
| */ |
| void onUserRestrictionsChanged(int userId, Bundle newRestrictions, Bundle prevRestrictions); |
| } |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} |
| * to set per-user as well as global user restrictions. |
| * |
| * @param userId target user id for the local restrictions. |
| * @param localRestrictions per-user restrictions. |
| * Caller must not change it once passed to this method. |
| * @param globalRestrictions global restrictions set by DO. Must be null when PO changed user |
| * restrictions, in which case global restrictions won't change. |
| * Caller must not change it once passed to this method. |
| */ |
| public abstract void setDevicePolicyUserRestrictions(int userId, |
| @NonNull Bundle localRestrictions, @Nullable Bundle globalRestrictions); |
| /** |
| * Returns the "base" user restrictions. |
| * |
| * Used by {@link com.android.server.devicepolicy.DevicePolicyManagerService} for upgrading |
| * from MNC. |
| */ |
| public abstract Bundle getBaseUserRestrictions(int userId); |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} for upgrading |
| * from MNC. |
| */ |
| public abstract void setBaseUserRestrictionsByDpmsForMigration(int userId, |
| Bundle baseRestrictions); |
| |
| /** Return a user restriction. */ |
| public abstract boolean getUserRestriction(int userId, String key); |
| |
| /** Adds a listener to user restriction changes. */ |
| public abstract void addUserRestrictionsListener(UserRestrictionsListener listener); |
| |
| /** Remove a {@link UserRestrictionsListener}. */ |
| public abstract void removeUserRestrictionsListener(UserRestrictionsListener listener); |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} to update |
| * whether the device is managed by device owner. |
| */ |
| public abstract void setDeviceManaged(boolean isManaged); |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} to update |
| * whether the user is managed by profile owner. |
| */ |
| public abstract void setUserManaged(int userId, boolean isManaged); |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} to omit |
| * restriction check, because DevicePolicyManager must always be able to set user icon |
| * regardless of any restriction. |
| * Also called by {@link com.android.server.pm.UserManagerService} because the logic of setting |
| * the icon is in this method. |
| */ |
| public abstract void setUserIcon(int userId, Bitmap bitmap); |
| |
| /** |
| * Called by {@link com.android.server.devicepolicy.DevicePolicyManagerService} to inform the |
| * user manager whether all users should be created ephemeral. |
| */ |
| public abstract void setForceEphemeralUsers(boolean forceEphemeralUsers); |
| |
| /** |
| * Switches to the system user and deletes all other users. |
| * |
| * <p>Called by the {@link com.android.server.devicepolicy.DevicePolicyManagerService} when |
| * the force-ephemeral-users policy is toggled on to make sure there are no pre-existing |
| * non-ephemeral users left. |
| */ |
| public abstract void removeAllUsers(); |
| |
| /** |
| * Called by the activity manager when the ephemeral user goes to background and its removal |
| * starts as a result. |
| * |
| * <p>It marks the ephemeral user as disabled in order to prevent it from being re-entered |
| * before its removal finishes. |
| * |
| * @param userId the ID of the ephemeral user. |
| */ |
| public abstract void onEphemeralUserStop(int userId); |
| |
| /** |
| * Same as UserManager.createUser(), but bypasses the check for DISALLOW_ADD_USER. |
| * |
| * <p>Called by the {@link com.android.server.devicepolicy.DevicePolicyManagerService} when |
| * createAndManageUser is called by the device owner. |
| */ |
| public abstract UserInfo createUserEvenWhenDisallowed(String name, int flags); |
| |
| /** |
| * Return whether the given user is running in an |
| * {@code UserState.STATE_RUNNING_UNLOCKING} or |
| * {@code UserState.STATE_RUNNING_UNLOCKED} state. |
| */ |
| public abstract boolean isUserUnlockingOrUnlocked(int userId); |
| |
| /** |
| * Return whether the given user is running |
| */ |
| public abstract boolean isUserRunning(int userId); |
| |
| /** |
| * Set user's running state |
| */ |
| public abstract void setUserState(int userId, int userState); |
| |
| /** |
| * Remove user's running state |
| */ |
| public abstract void removeUserState(int userId); |
| } |