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

بعد إيقاف واجهة برمجة التطبيقات تسجيل الدخول باستخدام Google نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تم دمجها حديثًا مع الإصدار v1 من حزمة SDK للألعاب على Google Play. ننصحك باستخدام الإصدار v2 من حزمة SDK للألعاب بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتضمّن عمليات الدمج السابقة للإصدار 1 من "خدمات ألعاب Google Play" ستستمر في العمل لعدّة سنوات، ننصحك بنقل البيانات إلى الإصدار 2 بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". لا تتوافق حزمة SDK الإصدار 2 من "خدمات ألعاب 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);
        }
      });
}

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

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

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