קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בעקבות ההוצאה משימוש של 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.
אתם יכולים להשתמש ב-Video Recording API כדי לשלב חוויית הקלטת וידאו ישירות מהמשחק.
חוויית צילום הווידאו של המשתמשים כוללת את האפשרויות הבאות:
שכבת-העל של הקלטת הווידאו, עם שלושה לחצנים:
הפעלה / הפסקה של ההקלטה
הפעלה / השבתה של המיקרופון
הפעלה או השבתה של המצלמה הקדמית
לחצן שסופק על ידי המפתח כדי להתחיל את ההקלטה, או טריגר חלופי להפעלת ההקלטה
הודעה קופצת שניתן ללחוץ עליה שמופיעה בסיום הצילום, ומאפשרת לשחקנים להעלות את הסרטון ל-YouTube או לצפות בו דרך אפליקציית Photos (הערה: סרטונים שתצלמו יישמרו בקטגוריה ScreenCasts ב-Photos)
הפעלת שכבת-העל של הקלטת הווידאו
כדי להתחיל את הקלטת הסרטון של המשתמש שמחובר כרגע, מבצעים את הפעולות הבאות:
ממשק ה-API להקלטת וידאו מאפשר לשלב חוויית הקלטת וידאו ישירות במשחק.
טיפ
תיאור
איך להציג את הטריגר להקלטת וידאו כך שיהיה קל למצוא אותו
הצבת לחצן הקלטה בולט מחוץ לתפריט הראשי
הפעלה אוטומטית של שכבת-העל מאפשרות תפריט ייעודית ומתויגת בבירור של מצב הצילום
קידום השימוש בתכונה בדף האפליקציה בחנות ובמשחק עצמו
להשתמש בצילום מסך בדף האפליקציה בחנות שבו מוצגת שכבת-העל של הקלטת הסרטון
קידום התכונה של הקלטת סרטונים באמצעות מבצעים במשחק
כדאי להציע פרסים במשחקים על שיתוף של הקלטות חוזרות
יצירת עניין בקרב קהילת השחקנים באמצעות תחרויות של קטעי משחק חוזרים
מעודדים את השחקנים להקליט ולשתף את ההקלטות החוזרות של המשחקים באמצעות תחרויות שבועיות, חודשיות או שנתיות
לזהות את הסרטונים והיוצרים המובילים במשחק או דרך רשתות חברתיות
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Video recording in Android games\n\nFollowing the deprecation of the\n[Google Sign-In](https://android-developers.googleblog.com/2024/09/streamlining-android-authentication-credential-manager-replaces-legacy-apis.html)\nAPI, we are removing the games v1 SDK in 2026. After February 2025, you will be unable to publish\ntitles that are newly integrated with games v1 SDK, on Google Play. We recommend that you use the\ngames v2 SDK instead. \n\nWhile existing titles with the previous games v1 integrations continue to function for a\ncouple of years, you are encouraged to\n[migrate to v2](/games/pgs/android/migrate-to-v2)\nstarting June 2025. \n\nThis guide is for using the Play Games Services v1 SDK. Video recording\nis not supported in the Play Games Services v2 SDK.\n\nThe video recording API enables you to easily add video recording to your game\nand let users share their videos with friends on YouTube in a few simple\nsteps. For example, you could add a button off of a battle replay screen that\nwhen pressed would bring up the Play Games video recording experience.\n\nThis guide shows you how to implement video recording in games using the\nGoogle Play Games Services. The APIs can be found in the\n[`com.google.android.gms.games.video`](https://developers.google.com/android/reference/com/google/android/gms/games/video/package-summary) and\n[`com.google.android.gms.games`](https://developers.google.com/android/reference/com/google/android/gms/games/package-summary) packages.\n\nBefore you begin\n----------------\n\nBefore you start to use the video recording API:\n\n- Download and review the\n [code sample](https://github.com/playgameservices/android-basic-samples).\n\n- Familiarize yourself with the recommendations described in the\n [Quality Checklist](/games/pgs/v1/quality).\n\nGet the videos client\n---------------------\n\nTo start using the video recording API, your game must first obtain a\n[`VideosClient`](https://developers.google.com/android/games_v1/reference/com/google/android/gms/games/VideosClient.html) object. You can do this by calling the\n[`Games.getVideosClient()`](https://developers.google.com/android/reference/com/google/android/gms/games/Games.html#getVideosClient(android.app.Activity,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) method and passing in the\nactivity and the [`GoogleSignInAccount`](https://developers.google.com/android/reference/com/google/android/gms/auth/api/signin/GoogleSignInAccount) for the current player. To learn how to\nretrieve the player account information, see\n[Sign-in in Android Games](/games/pgs/v1/android/signin).\n| **Note:** The [`VideosClient`](https://developers.google.com/android/games_v1/reference/com/google/android/gms/games/VideosClient.html) class makes use of the Google Play services [`Task`](https://developers.google.com/android/reference/com/google/android/gms/tasks/Task) class to return results asynchronously. To learn more about using tasks to manage threaded work, see the [Tasks API developer guide](https://developers.google.com/android/guides/tasks).\n\nVideo recording API basics\n--------------------------\n\nYou can use the video recording API to integrate a video recording experience\ndirectly from within your game.\n\nThe video recording experience for users includes the following:\n\n- The video recording overlay, which has three buttons:\n\n 1. Start / stop recording\n 2. Turn on / off mic\n 3. Turn on / off forward facing camera\n\n | **Note:** Clicking the overlay's forward facing camera display brings up the three aforementioned buttons.\n- A developer-provided button to initiate recording, or an alternate recording\n trigger\n\n- A clickable toast that pops up at the end of recording that enables players to\n upload the video to YouTube, or view the video through the Photos app\n (Note: recorded videos are stored under the category `ScreenCasts` in Photos)\n\nLaunch the video recording overlay\n----------------------------------\n\nTo initiate video recording for the currently signed-in player, follow these\nsteps:\n\n1. Call the [`VideosClient.getCaptureOverlayIntent()`](https://developers.google.com/android/reference/com/google/android/gms/games/VideosClient.html#getCaptureOverlayIntent()) method.\n2. If the call is successful, Google Play games services returns a [`Task`](https://developers.google.com/android/reference/com/google/android/gms/tasks/Task) object which asynchronously loads an intent to launch the video recording overlay.\n3. Use the intent from the previous step to start an activity.\n\nHere's an example of how to bring up the video recording overlay: \n\n```transact-sql\nprivate static final int RC_VIDEO_OVERLAY = 9011;\n\npublic void showVideoOverlay(View myview) {\n Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))\n .getCaptureOverlayIntent()\n .addOnSuccessListener(new OnSuccessListener\u003cIntent\u003e() {\n @Override\n public void onSuccess(Intent intent) {\n startActivityForResult(intent, RC_VIDEO_OVERLAY);\n }\n });\n}\n```\n\nTips for using video recording data\n-----------------------------------\n\nThe video recording API lets you integrate a video recording experience directly\nin your game.\n\n| Tip | Description |\n|----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Make the video recording trigger easily discoverable | - Prominently place a recording button off your main menu - Automatically trigger the overlay from a dedicated and clearly labeled recording mode menu option |\n| Promote use of the feature in your store listing and inside the game | - Use a screenshot in your store listing that displays the video recording overlay - Promote the video recording feature through in-game promotions - Consider providing in-game rewards for replay sharing |\n| Engage your player community with replay competitions | - Encourage players to record and share game replays with weekly / monthly / yearly replay competitions - Recognize top videos and creators in-game or through social media |"]]
