בעקבות הוצאה משימוש של Google Sign-In API, אנחנו מסירים את ה-SDK בגרסה Games v1 בשנת 2026. אחרי פברואר 2025, לא תהיה לך אפשרות לפרסם ב-Google Play משחקים ששולבו לאחרונה עם ה-SDK בגרסה Games v1. מומלץ להשתמש ב-SDK בגרסה Games v2.
משחקים קיימים עם שילובים קודמים של Games v1 ימשיכו לפעול למשך כמה שנים, אבל מומלץ לעבור לגרסה 2 החל מיוני 2025.
המדריך הזה מיועד לשימוש ב-Play Games Services SDK בגרסה 1. אין תמיכה בהקלטת סרטונים ב-Play Games Services v2 SDK.
ממשק ה-API להקלטת סרטונים מאפשר לכם להוסיף בקלות הקלטת סרטונים למשחק שלכם, ולאפשר למשתמשים לשתף את הסרטונים שלהם עם חברים ב-YouTube בכמה צעדים פשוטים. לדוגמה, אפשר להוסיף כפתור במסך של שידור חוזר של קרב, שכשלוחצים עליו מופיעה חוויית הקלטת הווידאו של Play Games.
במדריך הזה מוסבר איך להטמיע הקלטת סרטונים במשחקים באמצעות שירותי המשחקים של Google Play. ממשקי ה-API נמצאים בחבילות com.google.android.gms.games.video
ו-com.google.android.gms.games
.
לפני שמתחילים
לפני שמתחילים להשתמש ב-API להקלטת וידאו:
מורידים את דוגמת הקוד ובודקים אותה.
מומלץ לעיין בהמלצות שמפורטות ברשימת הבדיקה לאיכות.
הורדת אפליקציית הלקוח של Videos
כדי להתחיל להשתמש ב-Video Recording API, המשחק צריך קודם לקבל אובייקט VideosClient
. כדי לעשות את זה, צריך להפעיל את השיטה Games.getVideosClient()
ולהעביר את הפעילות ואת GoogleSignInAccount
של השחקן הנוכחי. במאמר כניסה למשחקי Android מוסבר איך לאחזר את פרטי חשבון השחקן.
היסודות של Video Recording API
אתם יכולים להשתמש ב-API להקלטת סרטונים כדי לשלב חוויית הקלטת סרטונים ישירות מתוך המשחק.
חוויית צילום הווידאו למשתמשים כוללת את הפעולות הבאות:
שכבת-העל של הקלטת הווידאו, שכוללת שלושה לחצנים:
- התחלה / הפסקה של ההקלטה
- הפעלה או השבתה של המיקרופון
- הפעלה או השבתה של המצלמה הקדמית
לחצן שסופק על ידי מפתח כדי להתחיל הקלטה, או טריגר חלופי להקלטה
הודעה קופצת שאפשר ללחוץ עליה, שמופיעה בסיום ההקלטה ומאפשרת לשחקנים להעלות את הסרטון ל-YouTube או לצפות בסרטון דרך אפליקציית Photos (הערה: סרטונים מוקלטים מאוחסנים בקטגוריה
ScreenCasts
ב-Photos)
הפעלת שכבת-העל של הקלטת הווידאו
כדי להתחיל הקלטת וידאו של השחקן שמחובר כרגע, מבצעים את השלבים הבאים:
- מבצעים קריאה ל-method
VideosClient.getCaptureOverlayIntent()
. - אם הקריאה מצליחה, שירותי Google Play Games מחזירים אובייקט
Task
שבאמצעותו נטען באופן אסינכרוני intent להפעלת שכבת-העל של הקלטת הסרטון. - משתמשים בכוונת המשתמש מהשלב הקודם כדי להתחיל פעילות.
דוגמה לאופן שבו מציגים את שכבת העל של הקלטת הסרטון:
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 להקלטת סרטונים מאפשר לכם לשלב חוויה של הקלטת סרטונים ישירות במשחק.
טיפ | תיאור |
---|---|
לוודא שקל למצוא את ההפעלה של הקלטת הסרטון |
|
קידום השימוש בתכונה בדף האפליקציה בחנות ובתוך המשחק |
|
יצירת קשר עם קהילת השחקנים באמצעות תחרויות של שידורים חוזרים |
|