ایجاد ارائه‌دهنده رسانه ابری برای Android

ارائه‌دهنده رسانه ابری محتوای رسانه ابری اضافی به انتخاب‌گر عکس Android ارائه می‌دهد. وقتی برنامه‌ای از ACTION_PICK_IMAGES یا ACTION_GET_CONTENT برای درخواست فایل‌های رسانه‌ای از کاربر استفاده می‌کند، کاربران می‌توانند عکس‌ها یا ویدیوهای ارائه‌شده توسط ارائه‌دهنده رسانه ابری را انتخاب کنند. ارائه‌دهنده رسانه ابری همچنین می‌تواند اطلاعاتی درباره آلبوم‌ها ارائه دهد که می‌توان آن‌ها را در انتخاب‌گر عکس Android مرور کرد.

قبل‌از شروع

قبل‌از شروع ساختن ارائه‌دهنده رسانه ابری، موارد زیر را درنظر بگیرید.

واجدشرایط بودن

Android درحال اجرای برنامه آزمایشی است تا به برنامه‌های نامزدشده OEM اجازه دهد ارائه‌دهنده رسانه ابری شوند. درحال‌حاضر، فقط برنامه‌هایی که توسط سازندگان اصلی تجهیزات نامزد شده‌اند واجدشرایط شرکت در این برنامه برای تبدیل شدن به ارائه‌دهنده رسانه ابری برای Android هستند. هر سازنده اصلی تجهیزات می‌تواند حداکثر ۳ برنامه را نامزد کند. پس‌از تأیید، این برنامه‌ها به‌عنوان ارائه‌دهندگان رسانه ابری در هر دستگاه Android مجهز به GMS که روی آن نصب شده‌اند، قابل‌دسترسی خواهند بود.

Android فهرستی از همه ارائه‌دهندگان ابری واجدشرایط را در سمت سرور نگهداری می‌کند. هر سازنده اصلی محصول می‌تواند بااستفاده از هم‌پوشانی قابل‌پیکربندی، ارائه‌دهنده ابری پیش‌فرضی را انتخاب کند. برنامه‌های نامزدشده باید همه الزامات فنی را برآورده کنند و همه آزمون‌های کیفیت را با موفقیت پشت سر بگذارند. برای کسب اطلاعات بیشتر درباره فرایند و الزامات برنامه آزمایشی ارائه‌دهنده رسانه ابری OEM، فرم پرس‌وجو را تکمیل کنید.

تصمیم بگیرید که آیا نیاز به ایجاد ارائه‌دهنده رسانه ابری دارید یا نه

ارائه‌دهندگان رسانه ابری برنامه‌ها یا سرویس‌هایی هستند که به‌عنوان منبع اصلی کاربر برای پشتیبان‌گیری و بازیابی عکس‌ها و ویدیوها از فضای ابری عمل می‌کنند. اگر برنامه‌تان کتابخانه‌ای از محتوای مفید دارد، اما معمولاً به‌عنوان راه‌حل ذخیره‌سازی عکس استفاده نمی‌شود، باید به‌جای آن ایجاد ارائه‌دهنده سند را درنظر بگیرید.

یک ارائه‌دهنده ابری فعال برای هر نمایه

برای هر نمایه Android، در هر زمان فقط یک ارائه‌دهنده رسانه ابری فعال می‌تواند وجود داشته باشد. کاربران ممکن است هرزمان بخواهند برنامه ارائه‌دهنده رسانه ابری انتخابی‌شان را از تنظیمات انتخاب‌گر عکس بردارند یا تغییر دهند.

به‌طور پیش‌فرض، انتخابگر عکس Android تلاش می‌کند ارائه‌دهنده ابری را به‌طور خودکار انتخاب کند.

  • اگر فقط یک ارائه‌دهنده ابری واجدشرایط در دستگاه وجود داشته باشد، آن برنامه به‌طور خودکار به‌عنوان ارائه‌دهنده فعلی انتخاب خواهد شد.
  • اگر بیش‌از یک ارائه‌دهنده ابری واجدشرایط در دستگاه وجود داشته باشد و یکی از آن‌ها با پیش‌فرض انتخاب‌شده توسط OEM مطابقت داشته باشد، برنامه انتخاب‌شده توسط OEM انتخاب خواهد شد.

  • اگر بیش‌از یک ارائه‌دهنده ابری واجدشرایط در دستگاه وجود داشته باشد و هیچ‌کدام از آن‌ها با پیش‌فرض انتخاب‌شده OEM مطابقت نداشته باشد، هیچ برنامه‌ای انتخاب نخواهد شد.

ساخت ارائه‌دهنده رسانه ابری

نمودار زیر توالی رویدادها را هم قبل و هم درطول جلسه انتخاب عکس بین برنامه Android، انتخاب‌گر عکس Android، MediaProvider دستگاه محلی، و CloudMediaProvider نشان می‌دهد.

نمودار توالی که جریان از انتخاب‌گر عکس به ارائه‌دهنده رسانه ابری را نشان می‌دهد
شکل ۱: نمودار توالی رویداد درطول جلسه انتخاب عکس.
  1. سیستم ارائه‌دهنده ابری ترجیحی کاربر را مقداردهی اولیه می‌کند و به‌طور دوره‌ای فراداده رسانه را با پس‌بک انتخاب‌گر عکس Android همگام‌سازی می‌کند.
  2. وقتی برنامه Android انتخاب‌گر عکس را راه‌اندازی می‌کند، قبل‌از نشان دادن شبکه ادغام‌شده موارد محلی یا ابری به کاربر، انتخاب‌گر عکس همگام‌سازی افزایشی حساس به تأخیر را با ارائه‌دهنده ابری انجام می‌دهد تا مطمئن شود نتایج تا حد امکان به‌روز هستند. پس‌از دریافت پاسخ یا وقتی مهلت به‌پایان می‌رسد، شبکه انتخاب‌گر عکس اکنون همه عکس‌های دردسترس را نمایش می‌دهد و عکس‌های ذخیره‌شده در دستگاهتان را با عکس‌های همگام‌سازی‌شده از فضای ابری ترکیب می‌کند.
  3. وقتی کاربر پیمایش می‌کند، انتخاب‌گر عکس ریزعکس‌های رسانه را از ارائه‌دهنده رسانه ابری واکشی می‌کند تا در میانای کاربر نمایش دهد.
  4. وقتی کاربر جلسه را تکمیل می‌کند و نتایج شامل یک فایل رسانه‌ای ابری است، انتخاب‌گر عکس توصیف‌گرهای فایل را برای محتوا درخواست می‌کند، یک URI تولید می‌کند، و دسترسی به فایل را به برنامه فراخواننده اعطا می‌کند.
  5. اکنون برنامه می‌تواند URI را باز کند و دسترسی فقط خواندنی به محتوای رسانه دارد. به‌طور پیش‌فرض، فراداده حساس محو می‌شود. انتخاب‌گر عکس از سیستم فایل FUSE برای هماهنگ کردن تبادل داده بین برنامه Android و ارائه‌دهنده رسانه ابری استفاده می‌کند.

مشکلات رایج

در اینجا چند نکته مهم وجود دارد که باید هنگام درنظر گرفتن پیاده‌سازی خود به‌خاطر داشته باشید:

جلوگیری از فایل‌های تکراری

ازآنجایی‌که انتخاب‌گر عکس Android راهی برای بررسی وضعیت رسانه ابری ندارد، CloudMediaProvider باید MEDIA_STORE_URI را در ردیف مکان‌نمای هر فایلی که هم در فضای ابری و هم در دستگاه محلی وجود دارد ارائه دهد، وگرنه کاربر فایل‌های تکراری را در انتخاب‌گر عکس خواهد دید.

بهینه‌سازی اندازه تصویر برای نمایش پیش‌نمایش

بسیار مهم است که فایل برگردانده‌شده از onOpenPreview تصویر با وضوح کامل نباشد و از Size درخواست‌شده پیروی کند. تصویر خیلی بزرگ زمان بار شدن را در میانای کاربر افزایش می‌دهد و تصویر خیلی کوچک ممکن است براساس اندازه صفحه‌نمایش دستگاه، پیکسلی یا تار شود.

رسیدگی به جهت درست

اگر ریزعکس‌های برگردانده‌شده در onOpenPreview حاوی داده‌های EXIF نباشند، باید در جهت درست برگردانده شوند تا از چرخش نادرست ریزعکس‌ها در شبکه پیش‌نمایش جلوگیری شود.

جلوگیری کردن از دسترسی غیرمجاز

قبل‌از برگرداندن داده به تماس‌گیرنده از ContentProvider، MANAGE_CLOUD_MEDIA_PROVIDERS_PERMISSION را بررسی کنید. این کار از دسترسی برنامه‌های غیرمجاز به داده‌های ابری جلوگیری می‌کند.

کلاس CloudMediaProvider

کلاس CloudMediaProvider که از android.content.ContentProvider مشتق شده است شامل روش‌هایی مانند روش‌های نشان‌داده‌شده در مثال زیر است:

کاتلین

abstract class CloudMediaProvider : ContentProvider() {

    @NonNull
    abstract override fun onGetMediaCollectionInfo(@NonNull bundle: Bundle): Bundle

    @NonNull
    override fun onQueryAlbums(@NonNull bundle: Bundle): Cursor = TODO("Implement onQueryAlbums")

    @NonNull
    abstract override fun onQueryDeletedMedia(@NonNull bundle: Bundle): Cursor

    @NonNull
    abstract override fun onQueryMedia(@NonNull bundle: Bundle): Cursor

    @NonNull
    abstract override fun onOpenMedia(
        @NonNull string: String,
        @Nullable bundle: Bundle?,
        @Nullable cancellationSignal: CancellationSignal?
    ): ParcelFileDescriptor

    @NonNull
    abstract override fun onOpenPreview(
        @NonNull string: String,
        @NonNull point: Point,
        @Nullable bundle: Bundle?,
        @Nullable cancellationSignal: CancellationSignal?
    ): AssetFileDescriptor

    @Nullable
    override fun onCreateCloudMediaSurfaceController(
        @NonNull bundle: Bundle,
        @NonNull callback: CloudMediaSurfaceStateChangedCallback
    ): CloudMediaSurfaceController? = null
}

جاوا

public abstract class CloudMediaProvider extends android.content.ContentProvider {

  @NonNull
  public abstract android.os.Bundle onGetMediaCollectionInfo(@NonNull android.os.Bundle);

  @NonNull
  public android.database.Cursor onQueryAlbums(@NonNull android.os.Bundle);

  @NonNull
  public abstract android.database.Cursor onQueryDeletedMedia(@NonNull android.os.Bundle);

  @NonNull
  public abstract android.database.Cursor onQueryMedia(@NonNull android.os.Bundle);

  @NonNull
  public abstract android.os.ParcelFileDescriptor onOpenMedia(@NonNull String, @Nullable android.os.Bundle, @Nullable android.os.CancellationSignal) throws java.io.FileNotFoundException;

  @NonNull
  public abstract android.content.res.AssetFileDescriptor onOpenPreview(@NonNull String, @NonNull android.graphics.Point, @Nullable android.os.Bundle, @Nullable android.os.CancellationSignal) throws java.io.FileNotFoundException;

  @Nullable
  public android.provider.CloudMediaProvider.CloudMediaSurfaceController onCreateCloudMediaSurfaceController(@NonNull android.os.Bundle, @NonNull android.provider.CloudMediaProvider.CloudMediaSurfaceStateChangedCallback);
}

کلاس CloudMediaProviderContract

علاوه‌بر کلاس پیاده‌سازی اصلی CloudMediaProvider، انتخاب‌گر عکس Android کلاس CloudMediaProviderContract را نیز دربرمی‌گیرد. این کلاس قابلیت همکاری بین انتخاب‌گر عکس و ارائه‌دهنده رسانه ابری را مشخص می‌کند و جنبه‌هایی مانند MediaCollectionInfo برای عملیات همگام‌سازی، ستون‌های Cursor پیش‌بینی‌شده، و موارد اضافی Bundle را دربرمی‌گیرد.

کاتلین

object CloudMediaProviderContract {

    const val EXTRA_ALBUM_ID = "android.provider.extra.ALBUM_ID"
    const val EXTRA_LOOPING_PLAYBACK_ENABLED = "android.provider.extra.LOOPING_PLAYBACK_ENABLED"
    const val EXTRA_MEDIA_COLLECTION_ID = "android.provider.extra.MEDIA_COLLECTION_ID"
    const val EXTRA_PAGE_SIZE = "android.provider.extra.PAGE_SIZE"
    const val EXTRA_PAGE_TOKEN = "android.provider.extra.PAGE_TOKEN"
    const val EXTRA_PREVIEW_THUMBNAIL = "android.provider.extra.PREVIEW_THUMBNAIL"
    const val EXTRA_SURFACE_CONTROLLER_AUDIO_MUTE_ENABLED = "android.provider.extra.SURFACE_CONTROLLER_AUDIO_MUTE_ENABLED"
    const val EXTRA_SYNC_GENERATION = "android.provider.extra.SYNC_GENERATION"
    const val MANAGE_CLOUD_MEDIA_PROVIDERS_PERMISSION = "com.android.providers.media.permission.MANAGE_CLOUD_MEDIA_PROVIDERS"
    const val PROVIDER_INTERFACE = "android.content.action.CLOUD_MEDIA_PROVIDER"

    object MediaColumns {
        const val DATE_TAKEN_MILLIS = "date_taken_millis"
        const val DURATION_MILLIS = "duration_millis"
        const val HEIGHT = "height"
        const val ID = "id"
        const val IS_FAVORITE = "is_favorite"
        const val MEDIA_STORE_URI = "media_store_uri"
        const val MIME_TYPE = "mime_type"
        const val ORIENTATION = "orientation"
        const val SIZE_BYTES = "size_bytes"
        const val STANDARD_MIME_TYPE_EXTENSION = "standard_mime_type_extension"
        const val STANDARD_MIME_TYPE_EXTENSION_ANIMATED_WEBP = 3 // 0x3
        const val STANDARD_MIME_TYPE_EXTENSION_GIF = 1 // 0x1
        const val STANDARD_MIME_TYPE_EXTENSION_MOTION_PHOTO = 2 // 0x2
        const val STANDARD_MIME_TYPE_EXTENSION_NONE = 0 // 0x0
        const val SYNC_GENERATION = "sync_generation"
        const val WIDTH = "width"
    }

    object AlbumColumns {
        const val DATE_TAKEN_MILLIS = "date_taken_millis"
        const val DISPLAY_NAME = "display_name"
        const val ID = "id"
        const val MEDIA_COUNT = "album_media_count"
        const val MEDIA_COVER_ID = "album_media_cover_id"
    }

    object MediaCollectionInfo {
        const val ACCOUNT_CONFIGURATION_INTENT = "account_configuration_intent"
        const val ACCOUNT_NAME = "account_name"
        const val LAST_MEDIA_SYNC_GENERATION = "last_media_sync_generation"
        const val MEDIA_COLLECTION_ID = "media_collection_id"
    }
}

جاوا

public final class CloudMediaProviderContract {

  public static final String EXTRA_ALBUM_ID = "android.provider.extra.ALBUM_ID";
  public static final String EXTRA_LOOPING_PLAYBACK_ENABLED = "android.provider.extra.LOOPING_PLAYBACK_ENABLED";
  public static final String EXTRA_MEDIA_COLLECTION_ID = "android.provider.extra.MEDIA_COLLECTION_ID";
  public static final String EXTRA_PAGE_SIZE = "android.provider.extra.PAGE_SIZE";
  public static final String EXTRA_PAGE_TOKEN = "android.provider.extra.PAGE_TOKEN";
  public static final String EXTRA_PREVIEW_THUMBNAIL = "android.provider.extra.PREVIEW_THUMBNAIL";
  public static final String EXTRA_SURFACE_CONTROLLER_AUDIO_MUTE_ENABLED = "android.provider.extra.SURFACE_CONTROLLER_AUDIO_MUTE_ENABLED";
  public static final String EXTRA_SYNC_GENERATION = "android.provider.extra.SYNC_GENERATION";
  public static final String MANAGE_CLOUD_MEDIA_PROVIDERS_PERMISSION = "com.android.providers.media.permission.MANAGE_CLOUD_MEDIA_PROVIDERS";
  public static final String PROVIDER_INTERFACE = "android.content.action.CLOUD_MEDIA_PROVIDER";
}

// Columns available for every media item
public static final class CloudMediaProviderContract.MediaColumns {

  public static final String DATE_TAKEN_MILLIS = "date_taken_millis";
  public static final String DURATION_MILLIS = "duration_millis";
  public static final String HEIGHT = "height";
  public static final String ID = "id";
  public static final String IS_FAVORITE = "is_favorite";
  public static final String MEDIA_STORE_URI = "media_store_uri";
  public static final String MIME_TYPE = "mime_type";
  public static final String ORIENTATION = "orientation";
  public static final String SIZE_BYTES = "size_bytes";
  public static final String STANDARD_MIME_TYPE_EXTENSION = "standard_mime_type_extension";
  public static final int STANDARD_MIME_TYPE_EXTENSION_ANIMATED_WEBP = 3; // 0x3
  public static final int STANDARD_MIME_TYPE_EXTENSION_GIF = 1; // 0x1 
  public static final int STANDARD_MIME_TYPE_EXTENSION_MOTION_PHOTO = 2; // 0x2 
  public static final int STANDARD_MIME_TYPE_EXTENSION_NONE = 0; // 0x0 
  public static final String SYNC_GENERATION = "sync_generation";
  public static final String WIDTH = "width";
}

// Columns available for every album item
public static final class CloudMediaProviderContract.AlbumColumns {

  public static final String DATE_TAKEN_MILLIS = "date_taken_millis";
  public static final String DISPLAY_NAME = "display_name";
  public static final String ID = "id";
  public static final String MEDIA_COUNT = "album_media_count";
  public static final String MEDIA_COVER_ID = "album_media_cover_id";
}

// Media Collection metadata that is cached by the OS to compare sync states.
public static final class CloudMediaProviderContract.MediaCollectionInfo {

  public static final String ACCOUNT_CONFIGURATION_INTENT = "account_configuration_intent";
  public static final String ACCOUNT_NAME = "account_name";
  public static final String LAST_MEDIA_SYNC_GENERATION = "last_media_sync_generation";
  public static final String MEDIA_COLLECTION_ID = "media_collection_id";
}

onGetMediaCollectionInfo

سیستم‌عامل از روش onGetMediaCollectionInfo() برای ارزیابی اعتبار موارد رسانه‌ای ابری ذخیره‌شده در حافظه نهان و تعیین همگام‌سازی لازم با ارائه‌دهنده رسانه ابری استفاده می‌کند. به‌دلیل احتمال فراخوانی‌های مکرر توسط سیستم‌عامل، onGetMediaCollectionInfo() ازنظر عملکرد حیاتی درنظر گرفته می‌شود؛ اجتناب از عملیات طولانی‌مدت یا عوارض جانبی که می‌تواند تأثیر منفی بر عملکرد داشته باشد بسیار مهم است. سیستم‌عامل پاسخ‌های قبلی این روش را ذخیره می‌کند و آن‌ها را با پاسخ‌های بعدی مقایسه می‌کند تا اقدامات مناسب را تعیین کند.

کاتلین

abstract fun onGetMediaCollectionInfo(extras: Bundle): Bundle

جاوا

@NonNull
public abstract Bundle onGetMediaCollectionInfo(@NonNull Bundle extras);

دسته MediaCollectionInfo برگردانده‌شده شامل ثابت‌های زیر است:

onQueryMedia

از روش onQueryMedia() برای پر کردن شبکه عکس اصلی در انتخاب‌گر عکس در نماهای مختلف استفاده می‌شود. این فراخوانی‌ها ممکن است به تأخیر حساس باشند و می‌توانند به‌عنوان بخشی از همگام‌سازی پیش‌کنشی پس‌زمینه یا درطول جلسه‌های انتخاب‌گر عکس که به وضعیت همگام‌سازی کامل یا افزایشی نیاز است فراخوانی شوند. میانای کاربر انتخاب‌گر عکس برای نمایش نتایج به‌طور نامحدود منتظر پاسخ نمی‌ماند و ممکن است این درخواست‌ها را برای اهداف میانای کاربر منقضی کند. مکان‌نمای برگردانده‌شده همچنان تلاش می‌کند تا برای جلسه‌های آینده در پایگاه داده انتخاب‌گر عکس پردازش شود.

این روش یک Cursor برمی‌گرداند که نشان‌دهنده همه فایل‌های رسانه‌ای در مجموعه رسانه است که به‌طور اختیاری توسط موارد اضافی ارائه‌شده فیلتر شده و به‌ترتیب زمانی معکوس MediaColumns#DATE_TAKEN_MILLIS (جدیدترین موارد در ابتدا) مرتب شده‌اند.

دسته CloudMediaProviderContract برگردانده‌شده شامل ثابت‌های زیر است:

ارائه‌دهنده رسانه ابری باید CloudMediaProviderContract#EXTRA_MEDIA_COLLECTION_ID را به‌عنوان بخشی از Bundle برگردانده‌شده تنظیم کند. تنظیم نکردن این مورد خطا است و Cursor برگردانده‌شده را نامعتبر می‌کند. اگر ارائه‌دهنده رسانه ابری هرگونه فیلتری را در موارد اضافی ارائه‌شده مدیریت کرده باشد، باید کلید را به‌عنوان بخشی از Cursor#setExtras برگردانده‌شده به ContentResolver#EXTRA_HONORED_ARGS اضافه کند.

onQueryDeletedMedia

از روش onQueryDeletedMedia() برای اطمینان از اینکه موارد حذف‌شده در حساب ابری به‌درستی از میانای کاربر انتخاب‌گر عکس برداشته شده‌اند استفاده می‌شود. به‌دلیل حساسیت احتمالی آن‌ها به تأخیر، این تماس‌ها ممکن است به‌عنوان بخشی از موارد زیر آغاز شوند:

  • همگام‌سازی پیش‌کنشی پس‌زمینه
  • جلسه‌های انتخاب‌گر عکس (وقتی وضعیت همگام‌سازی کامل یا افزایشی لازم است)

میانای کاربر انتخاب‌گر عکس تجربه کاربری واکنش‌گرا را در اولویت قرار می‌دهد و به‌طور نامحدود منتظر پاسخ نمی‌ماند. برای حفظ تعاملات روان، ممکن است وقفه زمانی رخ دهد. هر Cursor برگردانده‌شده همچنان تلاش می‌کند تا برای جلسه‌های آینده در پایگاه داده انتخاب‌گر عکس پردازش شود.

این روش یک Cursor برمی‌گرداند که نشان‌دهنده همه موارد رسانه‌ای حذف‌شده در کل مجموعه رسانه در نسخه ارائه‌دهنده فعلی است، همان‌طور که توسط onGetMediaCollectionInfo() برگردانده شده است. این موارد را می‌توان به‌طور اختیاری براساس موارد اضافی فیلتر کرد. ارائه‌دهنده رسانه ابری باید CloudMediaProviderContract#EXTRA_MEDIA_COLLECTION_ID را به‌عنوان بخشی از Cursor#setExtras برگردانده‌شده تنظیم کند. تنظیم نکردن این مورد خطا محسوب می‌شود و Cursor را نامعتبر می‌کند. اگر ارائه‌دهنده فیلترهایی را در موارد اضافی ارائه‌شده مدیریت کرده باشد، باید کلید را به ContentResolver#EXTRA_HONORED_ARGS اضافه کند.

onQueryAlbums

از روش onQueryAlbums() برای واکشی فهرست آلبوم‌های ابری که در ارائه‌دهنده ابری دردسترس هستند و فراداده‌های مرتبط با آن‌ها استفاده می‌شود. برای جزئیات بیشتر، CloudMediaProviderContract.AlbumColumns را ببینید.

این روش یک Cursor برمی‌گرداند که نشان‌دهنده همه موارد آلبوم در مجموعه رسانه است که به‌طور اختیاری توسط موارد اضافی ارائه‌شده فیلتر شده و به‌ترتیب زمانی معکوس AlbumColumns#DATE_TAKEN_MILLIS مرتب شده است، به‌طوری‌که جدیدترین موارد در ابتدا قرار می‌گیرند. ارائه‌دهنده رسانه ابری باید CloudMediaProviderContract#EXTRA_MEDIA_COLLECTION_ID را به‌عنوان بخشی از Cursor برگردانده‌شده تنظیم کند. تنظیم نکردن این مورد خطا است و Cursor برگردانده‌شده را نامعتبر می‌کند. اگر ارائه‌دهنده فیلترهایی را در موارد اضافی ارائه‌شده مدیریت کرده باشد، باید کلید را به ContentResolver#EXTRA_HONORED_ARGS به‌عنوان بخشی از Cursor برگردانده‌شده اضافه کند.

onOpenMedia

روش onOpenMedia() باید رسانه با اندازه کامل را که توسط mediaId ارائه‌شده شناسایی شده است برگرداند. If this method blocks while downloading content to the device, you should periodically check the provided CancellationSignal to abort abandoned requests.

onOpenPreview

روش onOpenPreview() باید ریزعکسی از size ارائه‌شده برای مورد mediaId ارائه‌شده برگرداند. ریزعکس باید در CloudMediaProviderContract.MediaColumns#MIME_TYPE اصلی باشد و انتظار می‌رود وضوح آن بسیار کمتر از موردی باشد که توسط onOpenMedia برگردانده شده است. اگر این روش هنگام بارگیری محتوا در دستگاه مسدود شود، باید به‌طور دوره‌ای CancellationSignal ارائه‌شده را بررسی کنید تا درخواست‌های رهاشده را لغو کنید.

onCreateCloudMediaSurfaceController

روش onCreateCloudMediaSurfaceController() باید CloudMediaSurfaceController را که برای رندر کردن پیش‌نمایش فایل‌های رسانه‌ای استفاده می‌شود برگرداند، یا null را اگر رندر کردن پیش‌نمایش پشتیبانی نمی‌شود برگرداند.

‫CloudMediaSurfaceController رندر کردن پیش‌نمایش فایل‌های رسانه‌ای را در نمونه‌های داده‌شده از Surface مدیریت می‌کند. روش‌های این کلاس باید ناهمگام باشند و نباید با انجام عملیات سنگین مسدود شوند. یک نمونه CloudMediaSurfaceController مسئول ارائه چندین فایل رسانه‌ای مرتبط با چندین سطح است.

CloudMediaSurfaceController از فهرست زیر برای فراخوانی‌های چرخه حیات پشتیبانی می‌کند: