AppFunctionService.OnExecuteFunction Méthode

Définition

Espace de noms:: Android.App.AppFunctions

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Appelé par le système suivant un AppFunctionManager#executeAppFunction appel qui cible un identificateur de fonction d’application référencé par la ressource XML associée à ce service.

[Android.Runtime.Register("onExecuteFunction", "(Landroid/app/appfunctions/ExecuteAppFunctionRequest;Ljava/lang/String;Landroid/content/pm/SigningInfo;Landroid/os/CancellationSignal;Landroid/os/OutcomeReceiver;)V", "GetOnExecuteFunction_Landroid_app_appfunctions_ExecuteAppFunctionRequest_Ljava_lang_String_Landroid_content_pm_SigningInfo_Landroid_os_CancellationSignal_Landroid_os_OutcomeReceiver_Handler", ApiSince=36)]
public abstract void OnExecuteFunction(Android.App.AppFunctions.ExecuteAppFunctionRequest request, string callingPackage, Android.Content.PM.SigningInfo callingPackageSigningInfo, Android.OS.CancellationSignal cancellationSignal, Android.OS.IOutcomeReceiver callback);

[<Android.Runtime.Register("onExecuteFunction", "(Landroid/app/appfunctions/ExecuteAppFunctionRequest;Ljava/lang/String;Landroid/content/pm/SigningInfo;Landroid/os/CancellationSignal;Landroid/os/OutcomeReceiver;)V", "GetOnExecuteFunction_Landroid_app_appfunctions_ExecuteAppFunctionRequest_Ljava_lang_String_Landroid_content_pm_SigningInfo_Landroid_os_CancellationSignal_Landroid_os_OutcomeReceiver_Handler", ApiSince=36)>]
abstract member OnExecuteFunction : Android.App.AppFunctions.ExecuteAppFunctionRequest * string * Android.Content.PM.SigningInfo * Android.OS.CancellationSignal * Android.OS.IOutcomeReceiver -> unit

Paramètres

request: ExecuteAppFunctionRequest

Demande d’exécution de fonction.

callingPackage: String

Nom du package de l’application qui demande l’exécution. Il est fortement recommandé de ne pas modifier le comportement de votre fonction en fonction de cette valeur. Votre fonction doit se comporter de manière cohérente pour tous les appelants afin de garantir une expérience prévisible. android.os.Build.VERSION_CODES#CINNAMON_BUNÀ compter de , la valeur sera toujours une chaîne vide.

callingPackageSigningInfo: SigningInfo

Informations de signature de l’application qui demandent l’exécution. Il est fortement recommandé de ne pas modifier le comportement de votre fonction en fonction de cette valeur. Votre fonction doit se comporter de manière cohérente pour tous les appelants afin de garantir une expérience prévisible. À compter de android.os.Build.VERSION_CODES#CINNAMON_BUN, la valeur sera toujours une information de signature inconnue.

cancellationSignal: CancellationSignal

Signal d’annulation de l’exécution.

callback: IOutcomeReceiver

Rappel pour signaler le résultat ou l’erreur.

Attributs: RegisterAttribute

Remarques

Appelé par le système pour exécuter une fonction d’application spécifique.

Cette méthode est le point d’entrée pour gérer toutes les demandes de fonction d’application dans une application. Lorsque le système a besoin de votre AppFunctionService pour effectuer une fonction, il appelle cette méthode.

Chaque fonction que vous avez inscrite est identifiée par un identificateur unique. Cet identificateur n’a pas besoin d’être globalement unique, mais il doit être unique dans votre application. Par exemple, une fonction pour commander des aliments peut être identifiée comme « order Food ». Dans la plupart des cas, cet identificateur est généré automatiquement par le Kit de développement logiciel (SDK) AppFunctions.

Vous pouvez déterminer la fonction à exécuter en appelant ExecuteAppFunctionRequest#getFunctionIdentifier(). Cela permet à votre service d’acheminer la requête entrante vers la logique appropriée pour gérer la fonction spécifique.

Cette méthode est toujours déclenchée dans le thread principal. Vous devez exécuter des tâches lourdes sur un thread de travail et distribuer le résultat avec le rappel donné. Vous devez toujours signaler le résultat à l’aide du rappel, peu importe si l’exécution a réussi ou non.

Cette méthode accepte également une CancellationSignal écoute de l’application pour annuler l’exécution de la fonction si elle est demandée par le système.

Java documentation pour android.app.appfunctions.AppFunctionService.onExecuteFunction(android.app.appfunctions.ExecuteAppFunctionRequest, java.lang.String, android.content.pm.SigningInfo, android.os.CancellationSignal, android.os.OutcomeReceiver<android.app.appfunctions.ExecuteAppFunctionResponse, android.app.appfunctions.AppFunctionException>).

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 à