לוחות לידרבורד יכולים להיות דרך מהנה לעודד תחרות בין השחקנים, גם בקרב המעריצים הכי נאמנים (שירצו להגיע למקום הראשון בלוח לידרבורד ציבורי) וגם בקרב שחקנים מזדמנים יותר (שירצו להשוות את ההתקדמות שלהם לזו של חברים).
כדי ללמוד איך להטמיע טבלאות הישגים בפלטפורמה שלכם, אתם יכולים להיעזר במאמר הטמעות בצד הלקוח.
הסבר על טבלאות הבאז
כשיוצרים טבלת מובילים, Play Games Services מטפל ברוב ההיבטים של טבלת המובילים הזו בשבילכם. התהליך הרגיל מתבצע כך:
- בסיום המשחק (או ברגע מתאים אחר שקבעתם), המשחק שולח את הניקוד של השחקן ללידרבורד אחד או יותר שיצרתם עבור המשחק.
- שירותי Play Games בודקים אם הניקוד הזה טוב יותר מהניקוד הנוכחי של השחקן בטבלת המובילים היומית, השבועית או בכל הזמנים. אם כן, מערכת Play Games Services מעדכנת את טבלאות המובילים המתאימות עם הניקוד החדש.
- שירותי Play Games שולחים דוח ניקוד בחזרה ללקוח המשחק. בדוח הזה הלקוח מקבל מידע אם מדובר בשיא חדש יומי, שבועי או כללי. אם לא, Play Games Services יגיד ללקוח מהו הניקוד היומי, השבועי או הגבוה ביותר בכל הזמנים של השחקן הזה.
- כדי לאחזר את התוצאות של שחקן בטבלת הישגים, אפשר לבקש מסגרת זמן (יומית, שבועית או כל הזמן) ולציין אם המשתמש רוצה לראות טבלת הישגים חברתית או ציבורית. שירותי Play Games מבצעים את כל הסינון הנדרש, ואז שולחים את התוצאות בחזרה ללקוח.
- במקרים שבהם יש הרבה תוצאות לדווח עליהן, שירות המשחקים של Play מחזיר רק את הנתונים של התוצאות הכי גבוהות בלוח הלידרבורד. אפשר גם לאחזר נתוני ניקוד גולמיים של הציונים הכי גבוהים או של הציונים שסמוכים לציון של השחקן.
כמה לוחות לידרבורד
במשחקים יכולים להיות כמה לוחות לידרבורד, עד 70 לוחות לכל היותר. לדוגמה, במשחק עם כמה רמות יכולה להיות טבלת הישגים שונה לכל רמה, ובמשחק מירוצים יכולה להיות טבלת הישגים נפרדת לכל מסלול.
מסגרות זמן בלידרבורד
ה-SDK של Play Games יוצר באופן אוטומטי גרסאות יומיות, שבועיות ושל כל הזמנים לכל לידרבורד שאתם יוצרים. אין צורך ליצור לוחות לידרבורד נפרדים לכל מסגרת זמן.
הטבלאות היומיות מתאפסות בשעה UTC-7 (כלומר, בחצות לפי שעון הקיץ באזור האוקיינוס השקט) לאורך כל השנה.
הטבלאות השבועיות מתאפסות בחצות בין שבת לראשון, באותו אזור זמן כמו הטבלאות היומיות (UTC-7).
טבלאות הישגים ציבוריות וחברתיות
ערכת Play Games SDK יכולה להציג לשחקן שתי גרסאות שונות של כל טבלת הישגים:
טבלת ההישגים החברתית היא טבלת הישגים שמורכבת מאנשים שנמצאים במעגלים של המשתמש (או ליתר דיוק, חברים במעגלים שהמשתמש בחר לשתף עם האפליקציה שלכם) שהחליטו לשתף עם המשתמש את הפעילות שלהם במשחק.
הלידרבורד הציבורי הוא לידרבורד שכולל שחקנים שבחרו לשתף את פעילות המשחק שלהם באופן ציבורי. אם השחקן לא בחר לשתף את הפעילות שלו במשחק באופן ציבורי, הוא לא יופיע בטבלת המובילים הזו.
הצגת טבלאות ההייפ
בספריות הלקוח לנייד, הספריות מטפלות בכל העיצוב וההצגה של טבלאות המובילים. אתם יכולים לציין אם שחקן יכול לראות טבלת הישגים ספציפית, או לראות רשימה של כל טבלאות ההישגים שלכם ולבחור מתוכה.
אפשר גם להטמיע גרסאות משלכם של טבלאות המובילים על ידי גישה לנתונים ישירות מספריות הלקוח.
מאפיינים
כדי ליצור ולנהל לוחות לידרבורד, כדאי להכיר את המאפיינים הבאים של לוחות לידרבורד:
העקרונות הבסיסיים
הרכיבים הבסיסיים האלה משויכים לכל טבלת לידרבורד:
- ID הוא מחרוזת ייחודית ש-Google Play Console ייצור בשבילכם. המזהה הייחודי הזה ישמש אתכם להתייחסות ללידרבורד בלקוחות של המשחק.
- שם הוא שם קצר לטבלת המובילים (לדוגמה, 'התוצאות הכי גבוהות' או 'רמה 3'). השם יכול לכלול עד 100 תווים.
- סמל הוא סמל מרובע שישויך לטבלת המובילים. הנחיות ליצירת סמלים לטבלת המובילים מפורטות במאמר הנחיות ליצירת סמלים.
- סדר הרשימה הוא הסדר שבו הלידרבורד יופיע כששחקן יצפה בלידרבורד שמשויך למשחק שלכם.
- מגבלות הן ערכים אופציונליים שמגדירים את הגבולות התחתונים והעליונים של התוצאות שמותרות בלידרבורד. כך תוכלו לפסול תוצאות ניקוד שמקורן בתרמית. אפשר גם להשתמש ב-
Players.hideכדי להסתיר שחקנים שלדעתכם שלחו תוצאות מזויפות מכל טבלאות המובילים באפליקציה.
סידור טבלאות ההייפ
יש שני סוגים של טבלאות הישגים:
- ברירת המחדל היא רשימות מובילים גדולות יותר. בדרך כלל זה מה שרואים ברוב המשחקים שבהם השחקנים צוברים נקודות.
- טבלאות עם ערכים קטנים עדיפות משמשות מדי פעם במקרים שבהם ציון נמוך יותר הוא טוב יותר. הדוגמאות הנפוצות ביותר לטבלת לידרבורד מהסוג הזה הן במשחקי מירוצים, שבהם הניקוד מייצג את הזמן שלקח לשחקן לסיים את המירוץ.
פורמט ניקוד
כל התוצאות נשלחות ללוחות התוצאות ומאוחסנות באופן פנימי כמספרים שלמים ארוכים, אבל Play Games Services יכול להציג אותן למשתמש במספר פורמטים שונים:
בלידרבורדים המספריים, התוצאות מוצגות כמספרים. אפשר להציג אותם כמספרים שלמים או כמספרים ממשיים עם מספר קבוע של מקומות אחרי הנקודה העשרונית. אתם שולחים את הציון כמספרים שלמים, והנקודה העשרונית מוזנת במיקום שצוין. לדוגמה, הניקוד
314159יוצג כ-3.14159,3141.59או314159, בהתאם למספר הספרות אחרי הנקודה העשרונית שציינתם.בטבלאות המובילים של Time, התוצאות מוצגות בפורמט של שעות / דקות / שניות / מאיות השנייה. חובה לשלוח את הניקוד במילישניות, כך שהערך
66032יפורש כ-1:06.03.לוחות הישגים של מטבעות מציגים את התוצאות בפורמט של מטבע. אתם שולחים ציונים כ-1 חלקי 1,000,000 של יחידת המטבע הראשית. לדוגמה, ציון של 19,950,000 יפורש כ-
$19.95, בהנחה שציינתם את המטבע שלכם כדולר ארה"ב.
בנוסף, אפשר להשתמש ביחידות מותאמות אישית בטבלאות הישגים מספריות. לדוגמה, אם במשחק שלכם התוצאות הגבוהות נמדדות במטרים, אתם יכולים לציין 'מטרים' כיחידת ברירת המחדל לטבלת ההישגים.
תרגומים ועיצוב הציון
כשספריות לקוח לנייד מבקשות נתונים של טבלת המובילים מ-Play Games Services, הן מציינות שפה ולוקאל שבהם יוצגו הניקודים האלה. ממשק ה-REST API מאפשר לכם לציין גם שפה שמבוססת על לוקאל. Play Games Services מחזיר ניקוד בטבלת המובילים בפורמט שמתאים לשפה וללוקאל. הציונים המעוצבים האלה יופיעו גם אם הוספתם תרגומים לטבלת המובילים וגם אם לא.
בטבלאות מספריות, הפורמט של המספרים מוצג באופן שונה בהתאם לשפה. (לדוגמה, 12,345.78 בארה"ב ו-12 345,78 בצרפת). אם אתם משתמשים ביחידות מותאמות אישית והוספתם תרגומים למשחק, אתם צריכים לספק יחידות מתורגמות לכל שפה שהוספתם. השירות יציג את היחידות המתורגמות האלה במקומות המתאימים.
יכול להיות שתצטרכו לספק גרסאות שונות של שמות היחידות, בהתאם לשפה שתבחרו. באנגלית תצטרכו גרסה לפריט אחד וגרסה לכל השאר (לדוגמה, meter ו-meters). לעומת זאת, בפולנית צריך לספק גרסה ליחידה אחת, לכמה יחידות, להרבה יחידות ולכל השאר. מידע נוסף על כללי ריבוי זמין במאמר בנושא מחרוזות של כמויות(צורות רבות).
בטבלאות המובילים של הזמן, פורמט הזמן מוצג בהתאם לשפה ולמיקום של השחקן. ההבדל יהיה מורגש בעיקר אם משתמשים בשבריר של שנייה או אם ערך השעות כולל יותר מ-3 ספרות (לדוגמה, 4,815:16:23.42 בארה"ב ו-4.815:16:23,42 בגרמניה).
בטבלאות המובילות של מטבע, פורמט המטבע יוצג בהתאם לשפה ולמיקום של השחקן. עם זאת, אי אפשר לשנות את יחידת המטבע. לדוגמה, אם המטבע שהגדרתם הוא דולר ארה"ב, המשחק יציג $19.95 בארה"ב ו-19,95 $ בצרפת. אבל אי אפשר לציין שהמשחק יציג דולרים בארה"ב ואירו בצרפת.
הנחיות לגבי סמלים
הסמלים צריכים להיות בפורמט PNG או JPEG ובגודל 512 x 512 פיקסלים. ברוב לקוחות המשחקים, הסמלים שלכם יוקטנו, לכן כדאי להימנע מיצירת סמלים עם יותר מדי פרטים קטנים. אפשר לשלוח סמלים עם ערוץ אלפא, והשקיפות תישמר. במכשירי Android, סמל הלידרבורד יוצג על רקע אפור כהה יותר, לכן חשוב לבחור סמל שמתאים למצב הזה.
אותו סמל משמש בכל הלוקאלים, ולכן לא מומלץ לכלול בסמל טקסט או תוכן שמותאם לשווקים מקומיים ספציפיים.
יצירת לידרבורד
בקטע הזה מוסבר איך ליצור לוחות לידרבורד למשחקים חדשים או קיימים.
יצירת לידרבורד למשחק חדש
כדי ליצור טבלת מובילים למשחק חדש שלא פורסם, עוברים אל הערך של המשחק ב-Google Play Console, אל צמיחה > Play Games Services > הגדרה וניהול > טבלאות מובילים, ואז לוחצים על הלחצן יצירת טבלת מובילים.
לאחר מכן, פשוט ממלאים את הפרטים שנדרשים ללידרבורד הזה.
לוחצים על שמירה כטיוטה, ורשימת המובילים תהיה זמינה במצב 'טיוטה'. אחרי שמפרסמים את המשחק, כל לוחות הלידרבורד שלו מתפרסמים יחד איתו.
יצירת לידרבורד למשחק שפורסם
כדי ליצור טבלת הישגים נוספת למשחק שכבר פורסם, פועלים לפי אותם השלבים שצוינו למעלה. מידע נוסף על בדיקת גרסה מעודכנת של משחק זמין במאמר פרסום השינויים במשחק.
אחרי שבדקתם את הלידרבורד ואתם מרוצים ממנו, אתם יכולים לפרסם מחדש את המשחק עם הלידרבורד החדש, והוא יופץ לכל העולם.
עריכת לידרבורד
כדי לערוך טבלת הישגים שכבר יצרתם, לוחצים על טבלת ההישגים בכרטיסייה טבלאות הישגים ב-Google Play Console. בשלב הזה, יוצג לכם אותו הטופס שבו השתמשתם כשבניתם את טבלת ההשוואה, ותוכלו לערוך את השדות לפי הצורך.
כשמסיימים לערוך את טבלת ההישגים, לוחצים על הלחצן שמירה כטיוטה. רשימת המובילים החדשה שנערכה תהיה במצב 'טיוטה', שמאפשר לכם לבדוק אותה.
אם הכול פועל כמו שצריך, בוחרים באפשרות פרסום השינויים בתיבה שבראש טופס טבלת המובילים, ואז אפשר לפרסם מחדש את המשחק עם כל טבלאות המובילים המעודכנות.
ביטול עריכה
אם החלטתם שאתם לא אוהבים את טבלת המובילים החדשה שערכתם ואתם רוצים לחזור לגרסה הקודמת, פשוט בוחרים באפשרות חזרה לגרסה הקודמת בתיבה שבראש טופס טבלת המובילים. טבלת המובילים תחזור לגרסה שכבר פורסמה.
מחיקת לידרבורד
אפשר למחוק לידרבורדים שנמצאים במצב 'טיוטה' או שכבר פורסמו. כדי למחוק לידרבורד ב-Google Play Console, עוברים לטופס של הלידרבורד ולוחצים על מחיקת הלידרבורד בחלק העליון של הטופס.
אפשר גם להתקשר למספר Players.hide כדי להסתיר את טבלת המובילים של נגן באפליקציה.
איפוס לידרבורד
אפשר לאפס נתוני התקדמות של שחקנים רק כשהלידרבורד במצב טיוטה.
- כדי לאפס את טבלת המובילים ב-Google Play Console, לוחצים על איפוס ההתקדמות בחלק העליון של הטופס של האירוע הרלוונטי.
- כדי לאפס את נתוני טבלת המובילים באופן פרוגרמטי, צריך להפעיל את שיטות
Scoresשל Management API.
הוספת תרגומים ללוחות לידרבורד
אתם יכולים לציין תרגומים משלכם ללידרבורדים שמשויכים למשחק שלכם. לפני שמתחילים, חשוב לוודא שמשלימים את השלבים שמתוארים במאמר הוספת תרגומים למשחק. בנוסף, צריך ליצור לידרבורד אחד או יותר למשחק.
כדי להוסיף תרגומים משלכם לטבלאות המובילים, פותחים את הכרטיסייה טבלאות מובילים של המשחק ב-Google Play Console, ואז בוחרים טבלת מובילים קיימת. בדף הפרטים של טבלת המובילים, לוחצים על הכרטיסייה של שפה שנוספה קודם בכרטיסייה פרטי המשחק. בדף פרטי הטבלה לשפה הזו, עורכים את הטופס ומוסיפים תרגומים לטבלה הזו. לוחצים על שמירה כדי לשמור את פרטי הטבלה.
הסתרת התוצאות בלידרבורד
Google Play Games Services כולל תכונה להגנה מפני זיוף בטבלת המובילים, שבודקת אם יש תוצאות ניקוד שנחשדות כתוצאות מזויפות ומסתירה אותן באופן אוטומטי. התכונה הזו זמינה רק במשחקי Android.
ההגנה מפני זיוף מופעלת כברירת מחדל בלידרבורדים חדשים שאתם יוצרים למשחק שלכם ל-Android, אבל היא מושבתת בלידרבורדים קיימים. כדי להפעיל הגנה מפני שיבוש נתונים בטבלאות לידרבורד קיימות שכבר פורסמו, פועלים לפי השלבים הבאים:
- ב-Google Play Console, פותחים את הכרטיסייה שירותי משחקים ובוחרים את המשחק מהרשימה.
- פותחים את הכרטיסייה טבלאות ההייפ ובוחרים את המופע של טבלת ההייפ שרוצים להפעיל בו הגנה מפני שיבוש.
- מעבירים את האפשרות הפעלת הגנה מפני זיוף בטבלת המובילים למצב מופעל.
- לוחצים על שמירה והמשך.
- מפרסמים את המשחק.
אחרי שמפעילים את ההגנה מפני שיבוש נתונים בטבלת הישגים ב-Google Play Console, יכול להיות שיחלפו עד 24 שעות לפני שהתכונה הזו תיכנס לתוקף. ציונים שנשלחו לפני שהפעלתם את ההגנה מפני שיבוש לא יוסתרו באופן רטרואקטיבי.
במקרים מסוימים, יכול להיות שתרצו להשבית את ההגנה מפני שיבוש (למשל, אם המשחק שלכם פועל גם באינטרנט בנוסף ל-Android, ויש לו טבלאות הישגים משותפות בפלטפורמות האלה).
הטמעות בצד הלקוח
כדי ללמוד איך להטמיע טבלאות הישגים בפלטפורמה שלכם, אתם יכולים להיעזר במקורות המידע הבאים: