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

پس از منسوخ شدن رابط برنامه‌نویسی کاربردی ورود گوگل (Google Sign-In API)، ما در سال ۲۰۲۶ کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) را حذف خواهیم کرد. پس از فوریه ۲۰۲۵، شما قادر به انتشار عناوینی که به تازگی با کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) ادغام شده‌اند، در گوگل پلی نخواهید بود. توصیه می‌کنیم به جای آن از کیت توسعه نرم‌افزاری بازی‌ها نسخه ۲ (games v2 SDK) استفاده کنید.
در حالی که عناوین موجود با بازی‌های قبلی نسخه ۱ ادغام‌شده تا چند سال دیگر به کار خود ادامه می‌دهند، توصیه می‌شود از ژوئن ۲۰۲۵ به نسخه ۲ مهاجرت کنید .
این راهنما برای استفاده از کیت توسعه نرم‌افزاری Play Games Services نسخه ۱ است. ضبط ویدیو در کیت توسعه نرم‌افزاری Play Games Services نسخه ۲ پشتیبانی نمی‌شود.

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

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

قبل از اینکه شروع کنی

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

• نمونه کد را دانلود و بررسی کنید.

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

کلاینت ویدیوها را دریافت کنید

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

نکته: کلاس VideosClient از کلاس Task سرویس‌های Google Play برای بازگرداندن نتایج به صورت غیرهمزمان استفاده می‌کند. برای کسب اطلاعات بیشتر در مورد استفاده از وظایف برای مدیریت کار رشته‌ای، به راهنمای توسعه‌دهنده API وظایف مراجعه کنید.

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

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

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

• پوشش ضبط ویدیو که دارای سه دکمه است:

  1. شروع/توقف ضبط
  2. روشن/خاموش کردن میکروفون
  3. روشن/خاموش کردن دوربین رو به جلو
  توجه: کلیک روی نمایشگر دوربین رو به جلوی لایه، سه دکمه‌ی ذکر شده را نمایش می‌دهد.

• دکمه‌ای که توسط توسعه‌دهنده برای شروع ضبط ارائه شده است، یا یک تریگر ضبط جایگزین

• یک پیام تبلیغاتی قابل کلیک که در پایان ضبط ظاهر می‌شود و به بازیکنان امکان می‌دهد ویدیو را در یوتیوب آپلود کنند یا از طریق برنامه Photos آن را مشاهده کنند (توجه: ویدیوهای ضبط شده در دسته ScreenCasts در Photos ذخیره می‌شوند)

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

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

1. متد VideosClient.getCaptureOverlayIntent() را فراخوانی کنید.
2. اگر فراخوانی موفقیت‌آمیز باشد، سرویس‌های بازی‌های گوگل پلی یک شیء Task را برمی‌گردانند که به صورت ناهمگام، یک intent برای راه‌اندازی پوشش ضبط ویدیو را بارگذاری می‌کند.
3. از intent مرحله قبل برای شروع یک activity استفاده کنید.

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

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 ضبط ویدیو به شما امکان می‌دهد تا یک تجربه ضبط ویدیو را مستقیماً در بازی خود ادغام کنید.

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