Sprache

AppFunctionMetadataScope Enumeration

Definition

public enum AppFunctionMetadataScope
type AppFunctionMetadataScope = 
Vererbung
AppFunctionMetadataScope

Felder

Name Wert Beschreibung
Global 0

Eine Konstante, die angibt, dass eine App-Funktion global ausgerichtet ist.

Es kann höchstens eine App-Funktionsimplementierung mit demselben AppFunctionName geben, der für diesen Bereich verfügbar ist. Dies ist nützlich für Funktionen, die an eine Singletonkomponente gebunden sind, z. B. einen Vordergrunddienst.

Bei Verwendung von AppFunctionManager.registerAppFunction bleibt die Funktion registriert, bis sie explizit aufgehoben wird oder der aufrufende Kontext zerstört wird.

Um eine global bereichsbezogene Funktion auszuführen, darf der Aufrufer von AppFunctionManager.executeAppFunction keine ExecuteAppFunctionRequest.Builder.setActivityId verwenden (oder auf NULL festlegen), andernfalls wird AppFunctionException.ERROR_FUNCTION_NOT_FOUND zurückgegeben.

Dies ist immer der Bereich für AppFunctionService-basierte Funktionen.

WICHTIG: Funktionen, die mit "AppFunctionManager.registerAppFunction" bereitgestellt werden, die aus einem Aktivitätskontext aufgerufen werden, sollten SCOPE_ACTIVITY bevorzugen. Verwenden Sie nur SCOPE_GLOBAL für solche Funktionen, wenn Sie absolut sicher sind, dass nur eine Instanz dieser Aktivität vorhanden sein kann.

Android-Referenz für android.app.appfunctions.AppFunctionMetadata.SCOPE_GLOBAL.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Activity 1

Eine Konstante, die angibt, dass eine App-Funktion den Aktivitätsbereich hat.

Mehrere App-Funktionsimplementierungen mit demselben AppFunctionName können gleichzeitig vorhanden sein, die jeweils aus einer anderen Aktivitätsinstanz registriert sind, die von einer AppFunctionActivityId identifiziert wird.

Funktionen mit diesem Bereich müssen mit "AppFunctionManager.registerAppFunction" registriert werden und aus einem Aktivitätskontext aufgerufen werden. Das Aufrufen aus einem anderen Kontext führt zu einer IllegalStateException.

Um eine aktivitätsbezogene Funktion auszuführen, muss der Aufrufer von AppFunctionManager.executeAppFunction ExecuteAppFunction executeAppFunction.builder.setActivityId verwenden, andernfalls wird AppFunctionException.ERROR_FUNCTION_NOT_FOUND zurückgegeben.

Informationen zum Ermitteln der spezifischen Aktivitäten, bei denen eine aktivitätsbezogene Funktion derzeit registriert ist, finden Sie unter "AppFunctionManager.getAppFunctionStates" und "AppFunctionManager.getAppFunctionActivityStates".

Die Funktion bleibt registriert, bis sie explizit nicht registriert ist oder die Aktivität zerstört wird.

WICHTIG: Funktionen, die mit "AppFunctionManager.registerAppFunction" bereitgestellt werden, die aus einem Aktivitätskontext aufgerufen werden, sollten SCOPE_ACTIVITY bevorzugen. Verwenden Sie nur SCOPE_GLOBAL für solche Funktionen, wenn Sie absolut sicher sind, dass nur eine Instanz dieser Aktivität vorhanden sein kann.

Android-Referenz für android.app.appfunctions.AppFunctionMetadata.SCOPE_ACTIVITY.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: