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

تتيح لك واجهة برمجة التطبيقات لتسجيل الفيديوهات إضافة ميزة تسجيل الفيديوهات إلى لعبتك بسهولة، والسماح للمستخدمين بمشاركة فيديوهاتهم مع الأصدقاء على 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);
        }
      });
}

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

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