AppFunctionService.OnExecuteFunction Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chamado pelo sistema para executar uma função de aplicativo específica.
[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 -> unitParâmetros
- request
- ExecuteAppFunctionRequest
A solicitação de execução da função.
- callingPackage
- String
O nome do pacote do aplicativo que está solicitando a execução. É altamente recomendável que você não altere o comportamento da função com base nesse valor. Sua função deve se comportar consistentemente para que todos os chamadores garantam uma experiência previsível.
- callingPackageSigningInfo
- SigningInfo
As informações de assinatura do aplicativo que está solicitando a execução. É altamente recomendável que você não altere o comportamento da função com base nesse valor. Sua função deve se comportar consistentemente para que todos os chamadores garantam uma experiência previsível.
- cancellationSignal
- CancellationSignal
Um sinal para cancelar a execução.
- callback
- IOutcomeReceiver
Um retorno de chamada para relatar o resultado ou o erro.
- Atributos
Comentários
Chamado pelo sistema para executar uma função de aplicativo específica.
Esse método é o ponto de entrada para lidar com todas as solicitações de função de aplicativo em um aplicativo. Quando o sistema precisar que seu AppFunctionService execute uma função, ele invocará esse método.
Cada função que você registrou é identificada por um identificador exclusivo. Esse identificador não precisa ser globalmente exclusivo, mas deve ser exclusivo em seu aplicativo. Por exemplo, uma função para pedir comida pode ser identificada como "orderFood". Na maioria dos casos, esse identificador é gerado automaticamente pelo SDK do AppFunctions.
Você pode determinar qual função executar chamando ExecuteAppFunctionRequest#getFunctionIdentifier(). Isso permite que seu serviço encaminhe a solicitação de entrada para a lógica apropriada para lidar com a função específica.
Esse método é sempre disparado no thread principal. Você deve executar tarefas pesadas em um thread de trabalho e expedir o resultado com o retorno de chamada especificado. Você sempre deve relatar o resultado usando o retorno de chamada, independentemente de a execução ter sido bem-sucedida ou não.
Esse método também aceita um CancellationSignal que o aplicativo deve escutar para cancelar a execução da função se solicitado pelo sistema.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.