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

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

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

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

قبل البدء

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

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

لبدء استخدام واجهة برمجة التطبيقات لتسجيل الفيديو، يجب أن تحصل لعبتك أولاً على عنصر VideosClient. يمكنك إجراء ذلك من خلال استدعاء طريقة Games.getVideosClient() وتمرير النشاط وGoogleSignInAccount للاعب الحالي. لمعرفة كيفية استرداد معلومات حساب اللاعب، راجِع تسجيل الدخول في ألعاب Android.

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

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

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

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

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

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

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

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