تسجيل الفيديو في ألعاب Android

بعد إيقاف واجهة برمجة التطبيقات Google Sign-In API نهائيًا، سنزيل حزمة تطوير البرامج (SDK) لألعاب الإصدار 1 في عام 2026. بعد شباط (فبراير) 2025، لن تتمكّن من نشر العناوين التي تم دمجها حديثًا مع حزمة تطوير البرامج (SDK) لإصدار 1 من "ألعاب Google Play" على Google Play. ننصحك باستخدام حزمة تطوير البرامج (SDK) لإصدار 2 من "ألعاب Google Play" بدلاً من ذلك.
على الرغم من أنّ العناوين الحالية التي تم دمجها مع الإصدار 1 من الألعاب السابقة ستظل تعمل لعدة سنوات، ننصحك بنقل بياناتها إلى الإصدار 2 اعتبارًا من حزيران (يونيو) 2025.
يتناول هذا الدليل استخدام حزمة تطوير البرامج (SDK) لإصدار 1 من "خدمات ألعاب Play". لا تتوفّر ميزة تسجيل الفيديو في حزمة تطوير البرامج (SDK) لإصدار 2 من "خدمات ألعاب Play".

تتيح لك واجهة برمجة التطبيقات لتسجيل الفيديوهات إضافة ميزة تسجيل الفيديوهات إلى لعبتك بسهولة، والسماح للمستخدمين بمشاركة فيديوهاتهم مع الأصدقاء على YouTube ببضع خطوات بسيطة. على سبيل المثال، يمكنك إضافة زر خارج شاشة إعادة عرض المعركة يؤدي عند الضغط عليه إلى عرض تجربة تسجيل الفيديو في "ألعاب Play".

يوضّح لك هذا الدليل كيفية تنفيذ ميزة تسجيل الفيديو في الألعاب باستخدام "خدمات ألعاب Google Play". يمكن العثور على واجهات برمجة التطبيقات في الحزم com.google.android.gms.games.video و com.google.android.gms.games.

قبل البدء

قبل بدء استخدام واجهة برمجة التطبيقات لتسجيل الفيديو:

الحصول على عميل الفيديوهات

لبدء استخدام واجهة برمجة تطبيقات تسجيل الفيديو، يجب أن تحصل لعبتك أولاً على عنصر VideosClient. يمكنك إجراء ذلك من خلال استدعاء الأسلوب Games.getVideosClient() وضبط القيمة activity وGoogleSignInAccount للمشغّل الحالي. للتعرّف على كيفية retrieving the player account information، يُرجى الاطّلاع على تسجيل الدخول في ألعاب Android.

أساسيات Video recording API

يمكنك استخدام واجهة برمجة التطبيقات Video Recording API لدمج تجربة تسجيل فيديو مباشرةً من داخل لعبتك.

تشمل تجربة تسجيل الفيديو للمستخدمين ما يلي:

  • تراكب تسجيل الفيديو الذي يتضمّن ثلاثة أزرار:

    1. بدء التسجيل أو إيقافه
    2. تفعيل الميكروفون أو إيقافه
    3. تفعيل الكاميرا الأمامية أو إيقافها

  • زر يقدّمه المطوّر لبدء التسجيل أو عامل تشغيل تسجيل بديلة

  • إشعار منبثق يمكن النقر عليه يظهر في نهاية التسجيل ويتيح للاعبينتحميل الفيديو إلى YouTube أو عرض الفيديو من خلال تطبيق "صور Google" (ملاحظة: يتم تخزين الفيديوهات المسجّلة ضمن الفئة ScreenCasts في "صور Google")

تشغيل شاشة تسجيل الفيديو

لبدء تسجيل الفيديو الخاص باللاعب الذي سجّل الدخول حاليًا، اتّبِع الخطوات التالية:

  1. استخدِم الطريقة VideosClient.getCaptureOverlayIntent().
  2. إذا كان الطلب ناجحًا، تُرجع "خدمات ألعاب Google Play" عنصرًا من نوع Task الذي يحمِّل بشكل غير متزامن نية لبدء تراكب تسجيل الفيديو.
  3. استخدِم النية من الخطوة السابقة لبدء نشاط.

في ما يلي مثال على كيفية عرض تراكب تسجيل الفيديو:

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);
        }
      });
}

نصائح حول استخدام بيانات تسجيل الفيديو

تتيح لك واجهة برمجة تطبيقات تسجيل الفيديو دمج تجربة تسجيل فيديو مباشرةً في لعبتك.

ملاحظة الوصف
تسهيل العثور على زر بدء تسجيل الفيديو
  • يجب وضع زر التسجيل بشكل بارز خارج القائمة الرئيسية.
  • تفعيل التراكب تلقائيًا من خيار قائمة مخصّص ومصنّف بوضوح لميزة وضع التسجيل
الترويج لاستخدام الميزة في بطاقة بيانات المتجر وداخل اللعبة
  • استخدِم لقطة شاشة في بطاقة بيانات المتجر تعرِض العنصر الذي يظهر على سطح الفيديو أثناء تسجيله.
  • الترويج لميزة تسجيل الفيديو من خلال العروض الترويجية داخل اللعبة
  • ننصحك بتوفير مكافآت داخل اللعبة مقابل مشاركة الإعادة.
جذب تفاعل من منتدى اللاعبين من خلال مسابقات إعادة تشغيل المباريات
  • شجِّع اللاعبين على تسجيل إعادة تشغيل المباريات ومشاركتها من خلال مسابقات أسبوعية أو شهرية أو سنوية لإعادة التشغيل.
  • التعرّف على أهم الفيديوهات وصنّاع المحتوى داخل اللعبة أو من خلال وسائل التواصل الاجتماعي