AppFunctionManager クラス

定義

[Android.Runtime.Register("android/app/appfunctions/AppFunctionManager", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class AppFunctionManager : Java.Lang.Object

[<Android.Runtime.Register("android/app/appfunctions/AppFunctionManager", ApiSince=36, DoNotGenerateAcw=true)>]
type AppFunctionManager = class
    inherit Object

継承

Object

JavaObject

Object

AppFunctionManager

属性

RegisterAttribute

注釈

App Functions へのアクセスを提供します。 現在、App Functions はベータ/試験段階のプレビュー機能です。

アプリ関数は、アプリ間オーケストレーションのためにアプリがシステムに公開する機能の一部です。

<h3>Building App Functions</h3>

ほとんどの開発者は、AppFunctions SDK を使用してアプリ関数を構築する必要があります。 この SDK ライブラリは、アプリ関数を構築するための便利でタイプ セーフな方法を提供します。 SDK には、一般的なユース ケース用の定義済みの関数スキーマと、関数パラメーターと戻り値に関連するデータ クラスが用意されています。 アプリは、提供されたインターフェイスのみを実装する必要があります。 内部的には、SDK はこれらのデータ クラスを ExecuteAppFunctionRequest#getParameters() と ExecuteAppFunctionResponse#getResultDocument()に変換します。

<h3>アプリ関数の検出</h3>

パッケージの変更がある場合、またはデバイスが起動すると、使用可能な関数のメタデータは、 AppSearchManagerによってデバイス上でインデックスが作成されます。 AppSearch は、インデックス付き情報を AppFunctionStaticMetadata ドキュメントとして格納します。 このドキュメントには、アプリ関数が実装する functionIdentifier とスキーマ情報が含まれています。 これにより、他のアプリとアプリ自体は、AppSearch 検索 API を使用してこれらの関数を検出できます。 このメタデータ ドキュメントの可視性は、アプリ関数を提供するアプリに対する可視性を持つパッケージに基づいています。 AppFunction SDK は、これを実現するための便利な方法を提供し、推奨される方法です。

<h3>アプリ関数の実行</h3>

アプリ関数を実行するために、呼び出し元アプリはfunctionIdentifier ドキュメントからAppFunctionStaticMetadataを取得し、それを使用してExecuteAppFunctionRequestを構築できます。 次に、アプリ関数を実行する要求で #executeAppFunction を呼び出します。 呼び出し元には、他のアプリからアプリ関数を実行するための android.permission.EXECUTE_APP_FUNCTIONS アクセス許可が必要です。 アプリは常に独自のアプリ関数を実行でき、これらのアクセス許可は必要ありません。 AppFunction SDK は、これを実現するための便利な方法を提供し、推奨される方法です。

<h3>Example</h3>

アシスタント アプリがユーザー要求 "SAVE XYZ into my note" を満たそうとしています。 アシスタント アプリでは、まず、使用可能なすべてのアプリ関数を AppSearch から AppFunctionStaticMetadata ドキュメントとして一覧表示する必要があります。 次に、 CreateNote スキーマを実装するアプリ関数を識別する必要があります。 最後に、アシスタント アプリは、選択した関数の#executeAppFunctionを使用してfunctionIdentifierを呼び出すことができます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。