این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

فیلمبرداری در بازی های اندروید

API ضبط ویدیو به شما این امکان را می دهد که به راحتی فیلم ضبط شده را به بازی خود اضافه کنید و به کاربران اجازه دهید ویدیوهای خود را با دوستان خود در YouTube در چند مرحله ساده به اشتراک بگذارند. برای مثال، می‌توانید دکمه خاموش کردن صفحه نمایش بازپخش نبرد را اضافه کنید که با فشار دادن آن، تجربه ضبط ویدیوی بازی‌های Play ظاهر می‌شود.

این راهنما به شما نشان می دهد که چگونه با استفاده از خدمات بازی های Google Play، ضبط ویدیو را در بازی ها پیاده سازی کنید. APIها را می‌توانید در بسته‌های com.google.android.gms.games.video و com.google.android.gms.games پیدا کنید.

قبل از شروع

قبل از شروع به استفاده از API ضبط ویدیو:

نمونه کد را دانلود و بررسی کنید.
با توصیه های شرح داده شده در چک لیست کیفیت آشنا شوید.

مشتری ویدیوها را دریافت کنید

برای شروع استفاده از API ضبط ویدیو، بازی شما ابتدا باید یک شی VideosClient داشته باشد. می‌توانید این کار را با فراخوانی متد Games.getVideosClient() و پاس کردن در Activity و GoogleSignInAccount برای بازیکن فعلی انجام دهید. برای یادگیری نحوه بازیابی اطلاعات حساب بازیکن، به ورود به سیستم در بازی‌های Android مراجعه کنید.

اصول API ضبط ویدیو

می‌توانید از API ضبط ویدیو برای ادغام تجربه ضبط ویدیو به طور مستقیم از داخل بازی خود استفاده کنید.

تجربه ضبط ویدیو برای کاربران شامل موارد زیر است:

پوشش فیلمبرداری که دارای سه دکمه است:
1. شروع / توقف ضبط
2. میکروفون را روشن/خاموش کنید
3. دوربین رو به جلو را روشن/خاموش کنید
توجه: با کلیک بر روی صفحه نمایش دوربین رو به جلو روکش، سه دکمه فوق ظاهر می شوند.
یک دکمه ارائه‌شده توسط توسعه‌دهنده برای شروع ضبط، یا یک ماشه ضبط جایگزین
یک نان تست قابل کلیک که در پایان ضبط ظاهر می شود و به بازیکنان امکان می دهد ویدیو را در YouTube آپلود کنند یا ویدیو را از طریق برنامه Photos مشاهده کنند (توجه: ویدیوهای ضبط شده در دسته ScreenCasts در عکس ها ذخیره می شوند)

پوشش ضبط ویدیو را راه اندازی کنید

برای شروع ضبط ویدیو برای پخش کننده ای که در حال حاضر وارد سیستم شده اید، این مراحل را دنبال کنید:

متد VideosClient.getCaptureOverlayIntent() را فراخوانی کنید.
اگر تماس با موفقیت انجام شود، سرویس‌های بازی‌های Google Play یک شی Task برمی‌گرداند که به‌طور ناهمزمان یک هدف برای راه‌اندازی پوشش ضبط ویدیو بارگیری می‌کند.
از intent مرحله قبل برای شروع یک فعالیت استفاده کنید.

در اینجا مثالی از نحوه نمایش همپوشانی ضبط ویدیو آورده شده است:

private static final int RC_VIDEO_OVERLAY = 9011;

public void showVideoOverlay(View myview) {
  Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .getCaptureOverlayIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_VIDEO_OVERLAY);
        }
      });
}

نکاتی برای استفاده از داده های ضبط ویدیو

API ضبط ویدیو به شما امکان می دهد تجربه ضبط ویدیو را مستقیماً در بازی خود ادغام کنید.

نکته	توضیحات
ماشه ضبط ویدیو را به راحتی قابل شناسایی کنید	یک دکمه ضبط را به طور برجسته در منوی اصلی خود قرار دهید به طور خودکار پوشش را از یک گزینه منوی حالت ضبط اختصاصی و با برچسب مشخص شده فعال کنید
استفاده از این ویژگی را در فهرست فروشگاه خود و داخل بازی تبلیغ کنید	از یک اسکرین شات در فهرست فروشگاه خود استفاده کنید که پوشش ضبط شده ویدیو را نمایش می دهد ویژگی ضبط ویدیو را از طریق تبلیغات درون بازی ارتقا دهید برای اشتراک‌گذاری مجدد، پاداش‌های درون بازی را در نظر بگیرید
جامعه بازیکنان خود را با مسابقات تکراری درگیر کنید	بازیکنان را تشویق کنید تا تکرارهای بازی را با مسابقات تکرار هفتگی / ماهانه / سالانه ضبط و به اشتراک بگذارند ویدیوها و سازندگان برتر در بازی یا از طریق رسانه های اجتماعی را بشناسید