このページは Cloud Translation API によって翻訳されました。

複数のユーザーの管理

このデベロッパーガイドでは、Device Policy Controller（DPC）が専用デバイスで複数の Android ユーザーを管理する方法について説明します。

概要

DPC を使用すると、複数のユーザーが 1 つの専用デバイスを共有できます。フルマネージドデバイスで実行される DPC では、次の 2 種類のユーザーを作成して管理できます。

セカンダリユーザーとは、セッション間で個別のアプリとデータが保存される Android ユーザーです。ユーザーは管理コンポーネントで管理します。このようなユーザーは、配達員やセキュリティワーカーなど、シフトの開始時にデバイスをピックアップする場合に便利です。
エフェメラルユーザーは、ユーザーが停止、切り替え、またはデバイスの再起動時にシステムにより削除されるセカンダリユーザーです。これらのユーザーは、公開アクセスのインターネットキオスクなど、セッション終了後にデータを削除できる場合に便利です。

既存の DPC を使用して専用デバイスとセカンダリユーザーを管理します。新しいセカンダリユーザーを作成すると、DPC の管理コンポーネントは自身を管理者として設定します。

プライマリユーザーと 2 人のセカンダリユーザー。 — **図 1:** 同じ DPC の管理者が管理するプライマリユーザーとセカンダリユーザー

セカンダリユーザーの管理者は、完全管理対象デバイスの管理者と同じパッケージに属している必要があります。開発を簡素化するために、デバイスとセカンダリユーザーの間で管理者を共有することをおすすめします。

専用デバイスで複数のユーザーを管理するには、通常は Android 9.0 が必要ですが、このデベロッパーガイドで使用している方法の一部は、以前のバージョンの Android で利用できます。

セカンダリユーザー

セカンダリユーザーは Wi-Fi に接続し、新しいネットワークを設定できます。ただし、作成したネットワークを含め、ネットワークの編集や削除はできません。

ユーザーを作成する

DPC は、バックグラウンドで追加のユーザーを作成して、フォアグラウンドに切り替えることができます。このプロセスは、セカンダリユーザーとエフェメラルユーザーの両方でほぼ同じです。完全管理対象デバイスとセカンダリユーザーの管理者に、次の手順を実装します。

DevicePolicyManager.createAndManageUser() を呼び出します。エフェメラルユーザーを作成するには、flags 引数に MAKE_USER_EPHEMERAL を含めます。
DevicePolicyManager.startUserInBackground() を呼び出して、バックグラウンドでユーザーを開始します。ユーザーはランニングを開始しますが、セットアップを完了してから、ユーザーをフォアグラウンドに移動して、デバイスを使用している人に提示する必要があります。
セカンダリユーザーの管理者として DevicePolicyManager.setAffiliationIds() を呼び出して、新しいユーザーをプライマリユーザーに関連付けます。後述の DPC の調整をご覧ください。
完全管理対象デバイスの管理者に戻り、DevicePolicyManager.switchUser() を呼び出してユーザーをフォアグラウンドに切り替えます。

次の例は、ステップ 1 を DPC に追加する方法を示しています。

Kotlin

val dpm = getContext().getSystemService(Context.DEVICE_POLICY_SERVICE)
        as DevicePolicyManager

// If possible, reuse an existing affiliation ID across the
// primary user and (later) the ephemeral user.
val identifiers = dpm.getAffiliationIds(adminName)
if (identifiers.isEmpty()) {
    identifiers.add(UUID.randomUUID().toString())
    dpm.setAffiliationIds(adminName, identifiers)
}

// Pass an affiliation ID to the ephemeral user in the admin extras.
val adminExtras = PersistableBundle()
adminExtras.putString(AFFILIATION_ID_KEY, identifiers.first())
// Include any other config for the new user here ...

// Create the ephemeral user, using this component as the admin.
try {
    val ephemeralUser = dpm.createAndManageUser(
            adminName,
            "tmp_user",
            adminName,
            adminExtras,
            DevicePolicyManager.MAKE_USER_EPHEMERAL or
                    DevicePolicyManager.SKIP_SETUP_WIZARD)

} catch (e: UserManager.UserOperationException) {
    if (e.userOperationResult ==
            UserManager.USER_OPERATION_ERROR_MAX_USERS) {
        // Find a way to free up users...
    }
}

Java

DevicePolicyManager dpm = (DevicePolicyManager)
    getContext().getSystemService(Context.DEVICE_POLICY_SERVICE);

// If possible, reuse an existing affiliation ID across the
// primary user and (later) the ephemeral user.
Set<String> identifiers = dpm.getAffiliationIds(adminName);
if (identifiers.isEmpty()) {
  identifiers.add(UUID.randomUUID().toString());
  dpm.setAffiliationIds(adminName, identifiers);
}

// Pass an affiliation ID to the ephemeral user in the admin extras.
PersistableBundle adminExtras = new PersistableBundle();
adminExtras.putString(AFFILIATION_ID_KEY, identifiers.iterator().next());
// Include any other config for the new user here ...

// Create the ephemeral user, using this component as the admin.
try {
  UserHandle ephemeralUser = dpm.createAndManageUser(
      adminName,
      "tmp_user",
      adminName,
      adminExtras,
      DevicePolicyManager.MAKE_USER_EPHEMERAL |
          DevicePolicyManager.SKIP_SETUP_WIZARD);

} catch (UserManager.UserOperationException e) {
  if (e.getUserOperationResult() ==
      UserManager.USER_OPERATION_ERROR_MAX_USERS) {
    // Find a way to free up users...
  }
}

新しいユーザーを作成または開始するときに、UserOperationException 例外をキャッチして getUserOperationResult() を呼び出すことで、失敗の理由を確認できます。一般的なエラーの原因は、ユーザーの上限を超えるとエラーになります。

ユーザーの作成には時間がかかることがあります。ユーザーを頻繁に作成する場合は、すぐに使用できるユーザーをバックグラウンドで準備することで、ユーザーエクスペリエンスを向上させることができます。場合によっては、すぐに使用できるユーザーの利点と、デバイスで許可される最大ユーザー数とのバランスを取る必要があります。

共感

新しいユーザーを作成したら、永続的なシリアル番号を持つユーザーを参照する必要があります。UserHandle は、ユーザーの作成時と削除時にシステムによってリサイクルされるため、保持しないでください。UserManager.getSerialNumberForUser() を呼び出してシリアル番号を取得します。

Kotlin

// After calling createAndManageUser() use a device-unique serial number
// (that isn’t recycled) to identify the new user.
secondaryUser?.let {
    val userManager = getContext().getSystemService(UserManager::class.java)
    val ephemeralUserId = userManager!!.getSerialNumberForUser(it)
    // Save the serial number to storage  ...
}

Java

// After calling createAndManageUser() use a device-unique serial number
// (that isn’t recycled) to identify the new user.
if (secondaryUser != null) {
  UserManager userManager = getContext().getSystemService(UserManager.class);
  long ephemeralUserId = userManager.getSerialNumberForUser(secondaryUser);
  // Save the serial number to storage  ...
}

ユーザー設定

ユーザーのニーズに応じて、セカンダリユーザーの設定をカスタマイズできます。createAndManageUser() を呼び出すときに、次のフラグを含めることができます。

SKIP_SETUP_WIZARD: アップデートの確認とインストール、Google サービスとともに Google アカウントの追加をユーザーに求めて、画面ロックを設定する、新しいユーザー設定ウィザードの実行をスキップします。この処理には時間がかかることがあります。また、すべてのユーザー（公共のインターネットキオスクなど）には該当しない場合があります。
LEAVE_ALL_SYSTEM_APPS_ENABLED: 新規ユーザーですべてのシステムアプリを有効のままにします。このフラグを設定しない場合、新しいユーザーには、スマートフォンが動作するために必要な最小限のアプリセット（通常はファイルブラウザ、電話アプリ、連絡先、SMS メッセージ）のみが含まれます。

ユーザーライフサイクルに従う

セカンダリユーザーが変更されるタイミングを DPC（完全管理対象デバイスの管理者の場合）で把握しておくと、便利な場合があります。変更後に後続のタスクを実行するには、DPC の DeviceAdminReceiver サブクラスで次のコールバックメソッドをオーバーライドします。

onUserStarted(): システムがユーザーを開始した後に呼び出されます。このユーザーは、まだセットアップ中であるか、バックグラウンドで動作している可能性があります。ユーザーは startedUser 引数から取得できます。
onUserSwitched(): システムが別のユーザーに切り替わった後に呼び出されます。現在フォアグラウンドで実行されている新規ユーザーは、switchedUser 引数から取得できます。
onUserStopped(): ユーザーがログアウトしたか、新しいユーザーに切り替えたか（ユーザーがエフェメラルの場合）、DPC がユーザーを停止したため、システムがユーザーを停止した後に呼び出されます。ユーザーは stoppedUser 引数から取得できます。
onUserAdded(): システムが新しいユーザーを追加したときに呼び出されます。通常、DPC がコールバックを受信したときに、セカンダリユーザーは完全に設定されていません。ユーザーは newUser 引数から取得できます。
onUserRemoved(): システムによってユーザーが削除された後に呼び出されます。ユーザーはすでに削除されているため、removedUser 引数で表されるユーザーにはアクセスできません。

システムがユーザーをフォアグラウンドに移動させるタイミング、またはユーザーをバックグラウンドに移動させるタイミングを把握するには、アプリで ACTION_USER_FOREGROUND ブロードキャストと ACTION_USER_BACKGROUND ブロードキャストのレシーバを登録します。

ユーザーを見つける

すべてのセカンダリユーザーを取得するには、完全管理対象デバイスの管理者が DevicePolicyManager.getSecondaryUsers() を呼び出します。結果には、管理者が作成したセカンダリユーザーまたはエフェメラルユーザーが含まれます。結果には、デバイスを使用しているユーザーが作成した可能性があるセカンダリユーザー（またはゲストユーザー）も含まれます。ユーザーはセカンダリユーザーではないため、結果に仕事用プロファイルは含まれません。次のサンプルは、この方法の使用方法を示しています。

Kotlin

// The device is stored for the night. Stop all running secondary users.
dpm.getSecondaryUsers(adminName).forEach {
    dpm.stopUser(adminName, it)
}

Java

// The device is stored for the night. Stop all running secondary users.
for (UserHandle user : dpm.getSecondaryUsers(adminName)) {
  dpm.stopUser(adminName, user);
}

セカンダリユーザーのステータスを確認するために、次の他のメソッドを呼び出します。

DevicePolicyManager.isEphemeralUser(): セカンダリユーザーの管理者からこのメソッドを呼び出して、エフェメラルユーザーかどうかを確認します。
DevicePolicyManager.isAffiliatedUser(): セカンダリユーザーの管理者からこのメソッドを呼び出して、このユーザーがプライマリユーザーと関連付けられているかどうかを確認します。アフィリエーションについて詳しくは、後述の DPC の調整をご覧ください。

ユーザー管理

ユーザーのライフサイクルを完全に管理する場合は、API を呼び出して、デバイスがユーザーを変更するタイミングと方法をきめ細かく制御できます。たとえば、デバイスが一定期間使用されなかった場合にユーザーを削除したり、ユーザーのシフトが終了する前に未送信の注文をサーバーに送信したりできます。

ログアウト

Android 9.0 では、デバイスを使用するユーザーがセッションを終了できるように、ロック画面にログアウトボタンが追加されました。ボタンをタップすると、システムはセカンダリユーザーを停止し、エフェメラルユーザーを削除して、プライマリユーザーがフォアグラウンドに戻ります。プライマリユーザーがフォアグラウンドにあるときは、プライマリユーザーがログアウトできないため、Android はボタンを非表示にします。

Android ではデフォルトでセッション終了ボタンは表示されませんが、完全管理対象デバイスの管理者は DevicePolicyManager.setLogoutEnabled() を呼び出すことでセッション終了ボタンを有効にできます。ボタンの現在の状態を確認する必要がある場合は、DevicePolicyManager.isLogoutEnabled() を呼び出します。

セカンダリユーザーの管理者は、プログラムでユーザーをログアウトしてプライマリユーザーに戻すことができます。まず、セカンダリユーザーとプライマリユーザーが関連付けられていることを確認してから、DevicePolicyManager.logoutUser() を呼び出します。ログアウトしたユーザーがエフェメラルユーザーの場合、システムはユーザーを停止して削除します。

ユーザーを切り替える

別のセカンダリユーザーに切り替えるには、完全管理対象デバイスの管理者が DevicePolicyManager.switchUser() を呼び出します。便宜上、null を渡してプライマリユーザーに切り替えることができます。

ユーザーの停止

セカンダリユーザーを停止するには、フルマネージドデバイスを所有する DPC が DevicePolicyManager.stopUser() を呼び出します。停止されたユーザーがエフェメラルユーザーの場合、ユーザーは停止されてから削除されます。

デバイスの最大実行ユーザー数を超えないように、可能な限りユーザーを停止することをおすすめします。

ユーザーを削除する

セカンダリユーザーを完全に削除するには、DPC で次のいずれかの DevicePolicyManager メソッドを呼び出します。

完全管理対象デバイスの管理者は、removeUser() を呼び出すことができます。
セカンダリユーザーの管理者は、wipeData() を呼び出すことができます。

一時ユーザーは、ログアウト、停止、または切り替えが行われたときに削除されます。

デフォルト UI を無効にする

DPC にユーザー管理用の UI が用意されている場合は、Android の組み込みのマルチユーザーインターフェースを無効にできます。これを行うには、次の例に示すように、DevicePolicyManager.setLogoutEnabled() を呼び出して DISALLOW_USER_SWITCH 制限を追加します。

Kotlin

// Explicitly disallow logging out using Android UI (disabled by default).
dpm.setLogoutEnabled(adminName, false)

// Disallow switching users in Android's UI. This DPC can still
// call switchUser() to manage users.
dpm.addUserRestriction(adminName, UserManager.DISALLOW_USER_SWITCH)

Java

// Explicitly disallow logging out using Android UI (disabled by default).
dpm.setLogoutEnabled(adminName, false);

// Disallow switching users in Android's UI. This DPC can still
// call switchUser() to manage users.
dpm.addUserRestriction(adminName, UserManager.DISALLOW_USER_SWITCH);

完全管理対象デバイスの管理者は DISALLOW_ADD_USER ユーザー制限を自動的に追加するため、デバイスを使用しているユーザーは、Android の組み込み UI でセカンダリユーザーを追加できません。

セッションメッセージ

デバイスを使用しているユーザーが新しいユーザーに切り替えると、Android にパネルが表示され、スイッチがハイライト表示されます。Android には次のメッセージが表示されます。

デバイスがプライマリユーザーからセカンダリユーザーに切り替わるときに表示される start-user-session メッセージ。
デバイスがセカンダリユーザーからプライマリユーザーに戻るときに表示される、エンドユーザーセッションメッセージ。

2 人のセカンダリユーザーを切り替えても、メッセージは表示されません。

メッセージはすべての状況に適しているとは限らないため、メッセージのテキストは変更できます。たとえば、ソリューションで一時的なユーザーセッションを使用する場合は、ブラウザセッションの停止と個人データの削除などのメッセージにその旨を反映できます。

メッセージは数秒間だけ表示されるため、各メッセージは短く明確なフレーズである必要があります。メッセージをカスタマイズするには、次の例に示すように、管理者は DevicePolicyManager メソッドの setStartUserSessionMessage() と setEndUserSessionMessage() を呼び出します。

Kotlin

// Short, easy-to-read messages shown at the start and end of a session.
// In your app, store these strings in a localizable resource.
internal val START_USER_SESSION_MESSAGE = "Starting guest session…"
internal val END_USER_SESSION_MESSAGE = "Stopping & clearing data…"

// ...
dpm.setStartUserSessionMessage(adminName, START_USER_SESSION_MESSAGE)
dpm.setEndUserSessionMessage(adminName, END_USER_SESSION_MESSAGE)

Java

// Short, easy-to-read messages shown at the start and end of a session.
// In your app, store these strings in a localizable resource.
private static final String START_USER_SESSION_MESSAGE = "Starting guest session…";
private static final String END_USER_SESSION_MESSAGE = "Stopping & clearing data…";

// ...
dpm.setStartUserSessionMessage(adminName, START_USER_SESSION_MESSAGE);
dpm.setEndUserSessionMessage(adminName, END_USER_SESSION_MESSAGE);

null を渡すと、カスタムメッセージを削除し、Android のデフォルトメッセージに戻ります。現在のメッセージテキストを確認する必要がある場合は、getStartUserSessionMessage() または getEndUserSessionMessage() を呼び出します。

DPC は、ユーザーの現在の言語 / 地域に合わせてローカライズされたメッセージを設定する必要があります。また、ユーザーの言語 / 地域が変更されたときに、メッセージを更新する必要もあります。

Kotlin

override fun onReceive(context: Context?, intent: Intent?) {
    // Added the <action android:name="android.intent.action.LOCALE_CHANGED" />
    // intent filter for our DeviceAdminReceiver subclass in the app manifest file.
    if (intent?.action === ACTION_LOCALE_CHANGED) {

        // Android's resources return a string suitable for the new locale.
        getManager(context).setStartUserSessionMessage(
                getWho(context),
                context?.getString(R.string.start_user_session_message))

        getManager(context).setEndUserSessionMessage(
                getWho(context),
                context?.getString(R.string.end_user_session_message))
    }
    super.onReceive(context, intent)
}

Java

public void onReceive(Context context, Intent intent) {
  // Added the <action android:name="android.intent.action.LOCALE_CHANGED" />
  // intent filter for our DeviceAdminReceiver subclass in the app manifest file.
  if (intent.getAction().equals(ACTION_LOCALE_CHANGED)) {

    // Android's resources return a string suitable for the new locale.
    getManager(context).setStartUserSessionMessage(
        getWho(context),
        context.getString(R.string.start_user_session_message));

    getManager(context).setEndUserSessionMessage(
        getWho(context),
        context.getString(R.string.end_user_session_message));
  }
  super.onReceive(context, intent);
}

DPC の調整

セカンダリユーザーを管理する場合は、通常、DPC の 2 つのインスタンスが必要です。1 つは完全管理対象デバイスを所有し、もう 1 つはセカンダリユーザーを所有します。新しいユーザーを作成するときに、完全管理対象デバイスの管理者が、別のインスタンス自身のインスタンスを新規ユーザーの管理者として設定します。

セットアップ

ユーザーが使用できるようにする前に、新しいセカンダリユーザー（セカンダリユーザーを所有する DPC から）を設定します。この設定を行うには、DeviceAdminReceiver.onEnabled() コールバックを使用します。以前に createAndManageUser() の呼び出しで管理者エクストラを設定した場合は、intent 引数から値を取得できます。次の例は、コールバックで新しいセカンダリユーザーを関連付ける DPC を示しています。

Kotlin

override fun onEnabled(context: Context?, intent: Intent?) {
    super.onEnabled(context, intent)

    // Get the affiliation ID (our DPC previously put in the extras) and
    // set the ID for this new secondary user.
    intent?.getStringExtra(AFFILIATION_ID_KEY)?.let {
        val dpm = getManager(context)
        dpm.setAffiliationIds(getWho(context), setOf(it))
    }
    // Continue setup of the new secondary user ...
}

Java

public void onEnabled(Context context, Intent intent) {
  // Get the affiliation ID (our DPC previously put in the extras) and
  // set the ID for this new secondary user.
  String affiliationId = intent.getStringExtra(AFFILIATION_ID_KEY);
  if (affiliationId != null) {
    DevicePolicyManager dpm = getManager(context);
    dpm.setAffiliationIds(getWho(context),
        new HashSet<String>(Arrays.asList(affiliationId)));
  }
  // Continue setup of the new secondary user ...
}

DPC 間の RPC

2 つの DPC インスタンスが別々のユーザーで実行されていても、デバイスを所有する DPC とセカンダリユーザーは相互に通信できます。別の DPC のサービスの呼び出しはユーザーの境界を越えるため、DPC は Android で通常発生するように bindService() を呼び出すことはできません。別のユーザーで実行されているサービスにバインドするには、DevicePolicyManager.bindDeviceAdminServiceAsUser() を呼び出します。

RPC を呼び出すプライマリユーザーと、関連する 2 つのセカンダリユーザー。 — **図 2.** サービスメソッドを呼び出す関連するプライマリユーザーとセカンダリユーザーの管理者

DPC は、DevicePolicyManager.getBindDeviceAdminTargetUsers() から返されたユーザーで実行されているサービスにのみバインドできます。次の例は、セカンダリユーザーの管理者と完全管理対象デバイスの管理者のバインディングを示しています。

Kotlin

// From a secondary user, the list contains just the primary user.
dpm.getBindDeviceAdminTargetUsers(adminName).forEach {

    // Set up the callbacks for the service connection.
    val intent = Intent(mContext, FullyManagedDeviceService::class.java)
    val serviceconnection = object : ServiceConnection {
        override fun onServiceConnected(componentName: ComponentName,
                                        iBinder: IBinder) {
            // Call methods on service ...
        }
        override fun onServiceDisconnected(componentName: ComponentName) {
            // Clean up or reconnect if needed ...
        }
    }

    // Bind to the service as the primary user [it].
    val bindSuccessful = dpm.bindDeviceAdminServiceAsUser(adminName,
            intent,
            serviceconnection,
            Context.BIND_AUTO_CREATE,
            it)
}

Java

// From a secondary user, the list contains just the primary user.
List<UserHandle> targetUsers = dpm.getBindDeviceAdminTargetUsers(adminName);
if (targetUsers.isEmpty()) {
  // If the users aren't affiliated, the list doesn't contain any users.
  return;
}

// Set up the callbacks for the service connection.
Intent intent = new Intent(mContext, FullyManagedDeviceService.class);
ServiceConnection serviceconnection = new ServiceConnection() {
  @Override
  public void onServiceConnected(
      ComponentName componentName, IBinder iBinder) {
    // Call methods on service ...
  }

  @Override
  public void onServiceDisconnected(ComponentName componentName) {
    // Clean up or reconnect if needed ...
  }
};

// Bind to the service as the primary user.
UserHandle primaryUser = targetUsers.get(0);
boolean bindSuccessful = dpm.bindDeviceAdminServiceAsUser(
    adminName,
    intent,
    serviceconnection,
    Context.BIND_AUTO_CREATE,
    primaryUser);

参考情報

専用デバイスの詳細については、次のドキュメントをご覧ください。

専用デバイスの概要では、専用デバイスの概要について説明します。
ロックタスクモードでは、専用デバイスを単一のアプリまたはアプリセットにロックする方法について説明します。
専用デバイスクックブック。専用デバイスを制限し、ユーザーエクスペリエンスを向上させる他の例が掲載されています。

複数のユーザーの管理

概要

セカンダリ ユーザー

ユーザーを作成する

Kotlin

Java

共感

Kotlin

Java

ユーザー設定

ユーザー ライフサイクルに従う

ユーザーを見つける

Kotlin

Java

ユーザー管理

ログアウト

ユーザーを切り替える

ユーザーの停止

ユーザーを削除する

デフォルト UI を無効にする

Kotlin

Java

セッション メッセージ

Kotlin

Java

Kotlin

Java

DPC の調整

関連付けられているユーザー

セットアップ

Kotlin

Java

DPC 間の RPC

Kotlin

Java

参考情報

セカンダリユーザー

ユーザーライフサイクルに従う

セッションメッセージ