AppFunctionMetadataScope 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public enum AppFunctionMetadataScopetype AppFunctionMetadataScope = - 継承
-
AppFunctionMetadataScope
フィールド
| 名前 | 値 | 説明 |
|---|---|---|
| Global | 0 | アプリ関数がグローバル スコープであることを示す定数。 このスコープで使用できる AppFunctionName と同じアプリ関数の実装は、最大で 1 つです。 これは、フォアグラウンド サービスなどのシングルトン コンポーネントに関連付けられている関数に役立ちます。 AppFunctionManager.registerAppFunction を使用する場合、関数は明示的に登録解除されるか、呼び出し元のコンテキストが破棄されるまで登録されたままになります。 グローバル スコープ関数を実行するには、AppFunctionManager.executeAppFunction の呼び出し元が ExecuteAppFunctionRequest.Builder.setActivityId (または null に設定) を使用しないでください。それ以外の場合は、AppFunctionException.ERROR_FUNCTION_NOT_FOUNDが返されます。 これは常に AppFunctionService ベースの関数のスコープです。 重要: アクティビティ コンテキストから呼び出される AppFunctionManager.registerAppFunction で提供される関数は、SCOPE_ACTIVITYを優先する必要があります。 そのアクティビティのインスタンスが 1 つしか存在できないことを絶対に確信している場合は、このような関数に対してSCOPE_GLOBALのみを使用してください。
|
| Activity | 1 | アプリ関数がアクティビティ スコープであることを示す定数。 同じ AppFunctionName を持つ複数のアプリ関数の実装が同時に存在でき、それぞれが異なるアクティビティ インスタンスから登録され、AppFunctionActivityId によって識別されます。 このスコープを持つ関数は、AppFunctionManager.registerAppFunction を使用して登録する必要があり、アクティビティ コンテキストから呼び出す必要があります。 他のコンテキストから呼び出すと、IllegalStateException が発生します。 アクティビティ スコープ関数を実行するには、AppFunctionManager.executeAppFunction の呼び出し元が ExecuteAppFunctionRequest.Builder.setActivityId を使用する必要があります。それ以外の場合は、AppFunctionException.ERROR_FUNCTION_NOT_FOUNDが返されます。 アクティビティ スコープ関数が現在登録されている特定のアクティビティを検出するには、AppFunctionManager.getAppFunctionStates と AppFunctionManager.getAppFunctionActivityStates を参照してください。 関数は、明示的に登録解除されるか、アクティビティが破棄されるまで登録されたままです。 重要: アクティビティ コンテキストから呼び出される AppFunctionManager.registerAppFunction で提供される関数は、SCOPE_ACTIVITYを優先する必要があります。 そのアクティビティのインスタンスが 1 つしか存在できないことを絶対に確信している場合は、このような関数に対してSCOPE_GLOBALのみを使用してください。
|