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

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

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

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

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

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

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

• מעיינים בהמלצות שמופיעות ברשימת המשימות לאיכות.

קבלת לקוח הסרטונים

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

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

היסודות של Video recording API

אתם יכולים להשתמש ב-API להקלטת סרטונים כדי לשלב חוויית הקלטת סרטונים ישירות מתוך המשחק.

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

• שכבת-העל של הקלטת הווידאו, שכוללת שלושה לחצנים:

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

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

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

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

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

1. מבצעים קריאה ל-method‏ VideosClient.getCaptureOverlayIntent().
2. אם הקריאה מצליחה, שירותי Google Play Games מחזירים אובייקט Task שבאמצעותו נטען באופן אסינכרוני intent להפעלת שכבת-העל של הקלטת הסרטון.
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 להקלטת סרטונים מאפשר לכם לשלב חוויה של הקלטת סרטונים ישירות במשחק.

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