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

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

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

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