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 參數傳遞給媒體或專輯查詢方法，提供者應該只回傳同步產生嚴格高於濾波器中提供的項目。

如果供應商支援此篩選器，必須支援相應 CloudMediaProvider#onGetMediaCollectionInfo 的回傳 count 媒體或 max generation 相簿與方法。

如果提供者處理了產生，他們必須將該金鑰加入 #EXTRA_SYNC_GENERATION 的陣列中，作為回傳 Cursor#setExtrasBundle。ContentResolver#EXTRA_HONORED_ARGS

的 android.provider.CloudMediaProviderContract.EXTRA_SYNC_GENERATIONJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。