Dataset クラス

定義

[Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Dataset : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)>]
type Dataset = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承

Object

Object

Dataset

属性

RegisterAttribute

実装

IParcelable IJavaObject IJavaPeerable IDisposable

注釈

オブジェクトは Dataset 、画面の一部をオートフィルするために使用されるフィールドのグループ (キーと値のペア) を表します。

オートフィル ワークフローにおけるデータセットの役割の詳細については、自動入力サービスの構築とドキュメントを <a href="/reference/android/service/autofill/AutofillService">AutofillService</a> 参照してください。

"BasicUsage"><h3>Basic usage</h3>

最も単純な形式では、データセットには 1 つ以上の AutofillId idフィールド (、a AutofillValue value、および省略可能なフィルター Pattern regexで構成) と、これらのフィールドに対して 1 つ以上 RemoteViews presentations のフィールドが含まれます (各フィールドには独自 RemoteViews presentationのフィールドが含まれるか、データセット全体に関連付けられている既定値 RemoteViews presentation を使用できます)。

オートフィル サービスが a のFillResponseデータセットを返し、画面入力がこれらのデータセットの少なくとも 1 つに存在するビューにフォーカスされている場合、Android システムには、そのビューAutofillIdを持つすべてのデータセット ペアを含む RemoteViews presentation UI が表示されます。 次に、ユーザーが UI からデータセットを選択すると、そのデータセット内のすべてのビューが自動入力されます。

現在の入力メソッドとオートフィル サービスの両方でインライン候補がサポートされている場合は、データセットを候補としてキーボードで表示できます。 この機能を使用するには、インライン提案 UI のレンダリング方法を表すデータセットが含まれている InlinePresentation 必要があります。

"FillDialogUI"><h3>Fill Dialog UI</h3>

塗りつぶしダイアログ UI は、ドロップダウン UI よりも目立つ効率的なインターフェイスです。 ユーザーがダイアログ UI の入力をサポートするフィールドをクリックしたときにオートフィル候補を使用できる場合は、オートフィルによって塗りつぶしダイアログがポップアップ表示されます。 ダイアログにはデータセットを表示するための領域が大きいので、ユーザーはデータセットに注意を払い、データセットを選択するのが簡単です。 ユーザーが提案を使用できるようになる前にビューにフォーカスを置くと、ドロップダウン UI またはインラインの候補にフォールバックします。

"Authentication"><h3>Dataset authentication</h3>

より高度な形式では、ユーザーが dataset&mdash を認証するまでデータセット値を保護できます。その場合、ユーザーがデータセットを選択すると、Android システムは、データセットの "ロック解除" を行うためにサービスによって設定された意図を起動します。

たとえば、データ セットにクレジット カード情報 (番号、有効期限、確認コードなど) が含まれている場合は、"Tap to authenticate" というデータセット プレゼンテーションを提供できます。 その後、ユーザーがそのオプションをタップすると、クレジット カード コードの入力をユーザーに求めるアクティビティが開始され、ユーザーが有効なコードを入力した場合は、データセットの "ロック解除" を行うことができます。

認証されたデータセットを使用して、ユーザーに対話型 UI を提供することもできます。 たとえば、自動入力されるアクティビティがアカウント作成画面である場合は、認証されたデータセットを使用して、ユーザーのランダム なパスワードを自動的に生成できます。

データセット認証メカニズムの詳細については、以下を参照 Dataset.Builder#setAuthentication(IntentSender) してください。

"Filtering"><h3>Filtering</h3>

オートフィル UI では、ビューを固定するビューの値に基づいて表示される値が自動的に変更されます。次の規則に従います。<ビュー>><android.view.View#getAutofillValue() autofill valueが空でないAutofillValue#isText() text場合、または空の場合は、すべてのデータセットが表示されます。 <li>フィルター正規表現 (set through Field.Builder#setFilter(Pattern) and) を持ち、 Dataset.Builder#setField(AutofillId, Field)正規表現が小文字に変換されたビューのテキスト値と一致するデータセットが表示されます。 <li>認証を必要としないデータセットには、ビューのテキストの小文字の値で始まるフィールド値AutofillValue#isText() textAutofillValue#getTextValue() valueが表示されます。 <li>他のすべてのデータセットは非表示です。 </Ol>

の Java ドキュメントandroid.service.autofill.Dataset

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象