הקלטת וידאו במשחקים ל-Android

ממשק ה-API להקלטת וידאו מאפשר לכם להוסיף בקלות הקלטת וידאו למשחק, ולאפשר למשתמשים לשתף את הסרטונים שלהם עם חברים ב-YouTube בכמה שלבים פשוטים. לדוגמה, תוכלו להוסיף לחצן למסך של שידור חוזר של קרב, שלחיצה עליו תציג את חוויית הצילום של סרטונים ב-Play Games.

במדריך הזה מוסבר איך להטמיע הקלטת וידאו במשחקים באמצעות שירותי Google Play Games. ממשקי ה-API נמצאים בחבילות com.google.android.gms.games.video ו-com.google.android.gms.games.

לפני שמתחילים

לפני שמתחילים להשתמש ב-Video Recording API:

• מורידים את דוגמת הקוד ובודקים אותה.

• כדאי לעיין בהמלצות שמפורטות ברשימת המשימות לבדיקת איכות.

אחזור הלקוח של הסרטונים

כדי להתחיל להשתמש ב-Video Recording API, המשחק צריך לקבל קודם אובייקט VideosClient. כדי לעשות זאת, צריך להפעיל את ה-method‏ Games.getVideosClient() ולהעביר את הפעילות ואת GoogleSignInAccount של הנגן הנוכחי. במאמר כניסה למשחקים ל-Android מוסבר איך לאחזר את פרטי חשבון השחקן.

יסודות של Video Recording API

אתם יכולים להשתמש ב-Video Recording API כדי לשלב חוויית הקלטת וידאו ישירות מהמשחק.

חוויית צילום הווידאו של המשתמשים כוללת את האפשרויות הבאות:

• שכבת-העל של הקלטת הסרטון, עם שלושה לחצנים:

  1. הפעלה / הפסקה של ההקלטה
  2. הפעלה / השבתה של המיקרופון
  3. הפעלה או כיבוי של המצלמה הקדמית

• לחצן שסופק על ידי המפתח כדי להתחיל את ההקלטה, או טריגר חלופי להפעלת ההקלטה

• הודעה קופצת שניתן ללחוץ עליה שמופיעה בסיום הצילום, ומאפשרת לשחקנים להעלות את הסרטון ל-YouTube או לצפות בו דרך אפליקציית Photos (הערה: סרטונים שתצלמו יישמרו בקטגוריה ScreenCasts ב-Photos)

הפעלת שכבת-העל של הקלטת הווידאו

כדי להתחיל את הצילום של השחקן שמחובר כרגע, מבצעים את הפעולות הבאות:

1. קוראים ל-method‏ VideosClient.getCaptureOverlayIntent().
2. אם הקריאה תתבצע בהצלחה, שירותי Google Play Games יחזירו אובייקט 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);
        }
      });
}

טיפים לשימוש בנתוני צילום הסרטון

ממשק ה-API להקלטת וידאו מאפשר לשלב חוויית הקלטת וידאו ישירות במשחק.