Langue

AppFunctionMetadataScope Énumération

Définition

public enum AppFunctionMetadataScope
type AppFunctionMetadataScope = 
Héritage
AppFunctionMetadataScope

Champs

Nom Valeur Description
Global 0

Constante indiquant qu’une fonction d’application est globale.

Il peut y avoir au maximum une implémentation de fonction d’application avec le même AppFunctionName disponible avec cette étendue. Cela est utile pour les fonctions liées à un composant singleton, comme un service de premier plan.

Lorsque vous utilisez AppFunctionManager.registerAppFunction, la fonction reste inscrite jusqu’à ce qu’elle soit explicitement annulée ou que le contexte appelant soit détruit.

Pour exécuter une fonction à étendue globale, l’appelant d’AppFunctionManager.executeAppFunction ne doit pas utiliser ExecuteAppFunctionRequest.Builder.setActivityId (ou le définir sur null), sinon AppFunctionException.ERROR_FUNCTION_NOT_FOUND sera retourné.

Il s’agit toujours de l’étendue des fonctions basées sur AppFunctionService.

IMPORTANT : Les fonctions fournies avec AppFunctionManager.registerAppFunction appelée à partir d’un contexte d’activité doivent préférer SCOPE_ACTIVITY. Utilisez uniquement SCOPE_GLOBAL pour ces fonctions si vous êtes absolument sûr qu’il ne peut y avoir qu’une seule instance de cette activité.

Référence Android pour android.app.appfunctions.AppFunctionMetadata.SCOPE_GLOBAL.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Activity 1

Constante indiquant qu’une fonction d’application est délimitée à l’activité.

Plusieurs implémentations de fonction d’application avec le même AppFunctionName peuvent exister simultanément, chacune inscrite à partir d’une instance d’activité différente, identifiée par un AppFunctionActivityId.

Les fonctions avec cette étendue doivent être inscrites à l’aide d’AppFunctionManager.registerAppFunction et doivent être appelées à partir d’un contexte d’activité. L’appel à partir d’un autre contexte entraîne une exception IllegalStateException.

Pour exécuter une fonction délimitée par l’activité, l’appelant d’AppFunctionManager.executeAppFunction doit utiliser ExecuteAppFunctionRequest.Builder.setActivityId, sinon, AppFunctionException.ERROR_FUNCTION_NOT_FOUND sera retourné.

Pour découvrir les activités spécifiques où une fonction étendue à une activité est actuellement inscrite, consultez AppFunctionManager.getAppFunctionStates et AppFunctionManager.getAppFunctionActivityStates.

La fonction reste inscrite jusqu’à ce qu’elle soit explicitement annulée ou que l’activité soit détruite.

IMPORTANT : Les fonctions fournies avec AppFunctionManager.registerAppFunction appelée à partir d’un contexte d’activité doivent préférer SCOPE_ACTIVITY. Utilisez uniquement SCOPE_GLOBAL pour ces fonctions si vous êtes absolument sûr qu’il ne peut y avoir qu’une seule instance de cette activité.

Référence Android pour android.app.appfunctions.AppFunctionMetadata.SCOPE_ACTIVITY.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à