Language

CompanionDeviceManager.Associate メソッド

定義

オーバーロード

Name 説明
Associate(AssociationRequest, CompanionDeviceManager+Callback, Handler)

ユーザーが選択したコンパニオン デバイスにこのアプリを関連付ける

Associate(AssociationRequest, IExecutor, CompanionDeviceManager+Callback)

このアプリをコンパニオン デバイスに関連付ける要求。

Associate(AssociationRequest, CompanionDeviceManager+Callback, Handler)

ユーザーが選択したコンパニオン デバイスにこのアプリを関連付ける

[Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Landroid/companion/CompanionDeviceManager$Callback;Landroid/os/Handler;)V", "", ApiSince=26)]
public void Associate(Android.Companion.AssociationRequest request, Android.Companion.CompanionDeviceManager.Callback callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Landroid/companion/CompanionDeviceManager$Callback;Landroid/os/Handler;)V", "", ApiSince=26)>]
member this.Associate : Android.Companion.AssociationRequest * Android.Companion.CompanionDeviceManager.Callback * Android.OS.Handler -> unit

パラメーター

request
AssociationRequest

この要求に関する具体的な詳細

callback
CompanionDeviceManager.Callback

ユーザーが選択できるデバイスが少なくとも 1 つ見つかったら、呼び出されます

handler
Handler

コールバックを配信するスレッドを制御するハンドラー(メイン スレッドで配信する場合は null)

属性

注釈

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Associate(AssociationRequest, IExecutor, CompanionDeviceManager+Callback)

このアプリをコンパニオン デバイスに関連付ける要求。

[Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Ljava/util/concurrent/Executor;Landroid/companion/CompanionDeviceManager$Callback;)V", "", ApiSince=33)]
public void Associate(Android.Companion.AssociationRequest request, Java.Util.Concurrent.IExecutor executor, Android.Companion.CompanionDeviceManager.Callback callback);
[<Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Ljava/util/concurrent/Executor;Landroid/companion/CompanionDeviceManager$Callback;)V", "", ApiSince=33)>]
member this.Associate : Android.Companion.AssociationRequest * Java.Util.Concurrent.IExecutor * Android.Companion.CompanionDeviceManager.Callback -> unit

パラメーター

request
AssociationRequest

要求の詳細を記述する要求オブジェクト。 この値は null にすることはできません。

executor
IExecutor

コールバックの呼び出しに使用される Executor。 この値は null にすることはできません。

callback
CompanionDeviceManager.Callback

関連付けが作成されたときにアプリケーションに通知するために使用されるコールバック。 この値は null にすることはできません。

属性

注釈

このアプリをコンパニオン デバイスに関連付ける要求。

アソシエーションの確立を作成する前に、システムでユーザーの確認を収集するために UI を表示する必要がある場合があることに注意してください。

アプリをバッテリ最適化から除外する (バックグラウンドで実行する) 必要がある場合、または無制限のデータ アクセス (バックグラウンドでデータを使用) する必要がある場合は、Manifest.permission.REQUEST_COMPANION_RUN_IN_BACKGROUNDとManifest.permission.REQUEST_COMPANION_USE_DATA_IN_BACKGROUNDの使用をそれぞれ AndroidManifest.xml で宣言する必要があります。 これらの特殊な機能は、デバイスのバッテリーとユーザーのデータ使用量に悪影響を与えるので、絶対に必要なときに要求する必要があります。

アプリケーションでは、getMyAssociations() を使用して、既存の関連付けを表す現在の AssociationInfo オブジェクトの一覧を取得できます。 アプリケーションでは、関連付けを削除するために disassociate(int) を使用することもできます。関連付けによって提供される特別な特権によって生じる不要なバッテリやデータのドレインを回避するために、関連付けが関連しなくなった場合に行うことをお勧めします

この API を使用してBluetooth デバイスに関連付ける場合は、この api を呼び出す前に、独自のBluetooth検出を取り消してください。そうしないと、コールバックが目的のデバイスを返できないことがあります。

この API を呼び出す場合は、マニフェストで機能PackageManager.FEATURE_COMPANION_DEVICE_SETUP宣言を使用する必要があります

android.companion.CompanionDeviceManager.associateの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象