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

בעקבות ההוצאה משימוש של API של כניסה באמצעות חשבון Google, אנחנו מסירים את ה-SDK של גרסה 1 למשחקים ב-2026. אחרי פברואר 2025, לא תוכלו לפרסם ב-Google Play כותרים ששולבו לאחרונה עם ערכת ה-SDK של גרסה 1 של משחקים. במקום זאת, מומלץ להשתמש ב-games v2 SDK.
כותרים קיימים עם השילובים הקודמים של המשחקים בגרסה 1 ימשיכו לפעול במשך כמה שנים, אבל מומלץ להעביר אותם לגרסה 2 החל מיוני 2025.
המדריך הזה מיועד לשימוש ב-SDK של Play Games Services v1. אין תמיכה בהקלטת סרטונים ב-Play Games Services v2 SDK.

ממשק ה-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 מוסבר איך לאחזר את פרטי חשבון השחקן.

הערה: הכיתה VideosClient משתמשת בכיתה Task של שירותי Google Play כדי להחזיר תוצאות באופן אסינכרוני. מידע נוסף על השימוש במשימות לניהול עבודה בשרשור זמין במדריך למפתחים של Tasks API.

יסודות של 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 להקלטת וידאו מאפשר לשלב חוויית הקלטת וידאו ישירות במשחק.

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