CloudMediaProviderContract.ExtraSyncGeneration フィールド

[Android.Runtime.Register("EXTRA_SYNC_GENERATION", ApiSince=33)]
public const string ExtraSyncGeneration;

[<Android.Runtime.Register("EXTRA_SYNC_GENERATION", ApiSince=33)>]
val mutable ExtraSyncGeneration : string

フィールド値

属性

RegisterAttribute

注釈

メディア コレクションから最新のメディアまたはアルバム メタデータの変更をフェッチする世代番号。

プロバイダーは、単調に増加する同期生成を各メディア項目の変更 (挿入/削除/更新) に関連付ける必要があります。 これは、以前の時点以降に変更されたメディア項目をすばやく特定するのに役立ちます。

また、プロバイダーは、アルバムの変更 (挿入/削除/更新) に対して、単調に増加する別の同期生成を関連付ける必要があります。 このアルバム同期生成では、アルバム メタデータ自体の変更と、アルバムに含まれるメディア項目の変更の両方を記録する必要があります。 たとえば、アルバムの CloudMediaProviderContract.AlbumColumns#DISPLAY_NAME を直接変更すると、アルバムの同期の生成が増加します。同様に、そのアルバムに写真を追加すると、同期の生成も増加します。

クエリ API の観点から変更全体がアトミックに見える限り、複数のメディア (またはアルバム) 項目が同期生成を共有できることに注意してください。 たとえば、クラウドからのバッチ写真同期内の各項目は、外部オブザーバーの観点からコレクションにアトミックに同期された場合、同じ同期生成を持つことができます。

この追加は、メディアまたはアルバムのクエリ メソッドに Bundle パラメーターとして渡すことができます。プロバイダーは、フィルターで指定されたものよりも厳密に大きい同期生成を持つ項目のみを返す必要があります。

プロバイダーがこのフィルターをサポートしている場合は、メディアまたはアルバムのcountとmax generationを返すために、それぞれのCloudMediaProvider#onGetMediaCollectionInfo メソッドをサポートする必要があります。

プロバイダーが生成を処理した場合は、返されたCursor#setExtrasBundleの一部として、ContentResolver#EXTRA_HONORED_ARGSの配列に#EXTRA_SYNC_GENERATION キーを追加する必要があります。

Javaドキュメント。

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