שילוב ההישגים

יצירת הישג

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

1. ב-Google Play Console, בוחרים משחק.
2. בדף שירותי המשחקים של Play – הישגים (צמיחה > שירותי המשחקים של Play > הגדרה וניהול > הישגים), בוחרים באפשרות יצירת הישג.
3. בדף הוספת הישגים, ממלאים את הטופס.
4. לוחצים על שמירה כטיוטה.
5. אחרי שיוצרים הישג, צריך לפרסם אותו.

ייבוא הישגים

כדי להוסיף כמה הישגים למשחק בבת אחת:

1. יוצרים קובץ ZIP שמכיל את ההישגים.
2. מעלים את הקובץ.

מידע נוסף על קובץ ה-ZIP זמין במאמר בנושא הנחיות לגבי קובץ ZIP.

כדי לייבא הישגים:

1. ב-Google Play Console, בוחרים משחק.
2. בדף Play Games Services - Achievements (צמיחה > Play Games Services > הגדרה וניהול > הישגים), בוחרים באפשרות ייבוא הישגים.
3. בדף ייבוא הישגים, לוחצים על העלאה.
4. בוחרים את קובץ ה-zip להעלאה.
5. לוחצים על שמירה כטיוטה.
6. אחרי שמייבאים הישגים, צריך לפרסם את המשחק.

הנחיות לגבי קובצי ZIP

אפשר לייבא כמה הישגים בבת אחת באמצעות קובץ ZIP. בטבלה מפורטים שמות הקבצים המדויקים שבהם צריך להשתמש בקובץ ה-ZIP:

הדרישות לגבי קובץ ה-ZIP:

• אין ספריות משנה.
• שמות קבצים ייחודיים.
• אפשר להעלות רק קובצי CSV,‏ PNG,‏ JPEG או JPG.
• קבצי ה-CSV לא יכולים לכלול שורת כותרת.
• כל קובץ צריך להיות קטן מ-1MB.
• קובץ ה-ZIP לא יכול להכיל יותר מ-203 קבצים.
• הגודל הכולל של קובץ ה-ZIP צריך להיות קטן מ-200MB.

הפורמט של הקובץ AchievementsMetadata.csv

הקובץ AchievementsMetadata.csv מכיל את המטא-נתונים של כל הישג. היא צריכה לכלול את המידע כערכים מופרדים בפסיקים בסדר הבא:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

השדות האלה מתוארים בטבלה הבאה:

דרישות לגבי הקובץ AchievementsMetadata.csv:

• כל שורה צריכה להכיל שבעה ערכים. אם רוצים להשמיט ערך, משאירים אותו ריק.
• השדות Name ו-Description משמשים כמקום ברירת המחדל.
• השדה Name צריך להיות ייחודי לכל ההישגים.
• השדות הבאים לא יכולים להכיל פסיקים: Name ו-Description.

קובץ AchievementsMetadata.csv לדוגמה:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

הפורמט של הקובץ AchievementsLocalizations.csv

קובץ AchievementsLocalizations.csv הוא קובץ אופציונלי שמגדיר את כל הנתונים שנדרשים כדי לתאר כל הישג למשתמשים באזורים שונים. ההישגים מתורגמים בהתאם ללוקאלים שצוינו למשחק.

היא צריכה לכלול את המידע כערכים מופרדים בפסיקים בסדר הבא:

   Name, Localized name, Localized description, locale

השדות האלה מתוארים בטבלה הבאה:

AchievementsLocalizations.csv הדרישות לגבי קבצים:

• שמות ההישגים במשחק צריכים להיות ייחודיים בכל לוקאל.

  לדוגמה, אם משחק תומך באזורים en-US ו-fr-FR, הישג בשם Achievement1 עבור en-US יכול להיקרא גם Achievement1 עבור fr-FR.

• כל שורה צריכה להכיל ארבעה ערכים. אם רוצים להשמיט את הערך של Localized description, משאירים אותו ריק.

קובץ AchievementsLocalizations.csv לדוגמה:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

הפורמט של AchievementsIconMappings.csv

קובץ AchievementsIconMappings.csv הוא קובץ אופציונלי שמשמש למיפוי ההישגים שלכם עם הסמל שצוין. היא צריכה לכלול את המידע כערכים מופרדים בפסיקים בסדר הבא:

Name, icon filename

השדות האלה מתוארים בטבלה הבאה

AchievementsIconMappings.csv הדרישות לגבי קבצים:

• כל שורה צריכה להכיל שני ערכים.
• קובצי סמלים יכולים להיות רק בפורמט PNG או JPEG.

קובץ AchievementsIconMappings.csv לדוגמה:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

הנחיות לגבי סמלים

הסמלים צריכים להיות בפורמט PNG, ‏ JPEG או JPG, במידות ‎512 x 512 פיקסלים. אתם צריכים לשלוח לנו רק את הסמל של ההישג שלא נעול. המערכת תיצור באופן אוטומטי גרסת גווני אפור לסמל שמוצג. לכן, מומלץ להוסיף לסמלי ההישגים אלמנטים צבעוניים, כדי שהמשתמשים יוכלו להבחין בין הישגים שנחשפו לבין הישגים שנפתחו.

כשסמל של הישג מוצג ב-Android [toast][a], הסמל מופיע על רקע של עיגול והפינות החיצוניות שלו מוסתרות. חשוב לוודא שהסמל עדיין נראה טוב בנסיבות האלה.

אותו סמל משמש בכל הלוקאלים, ולכן לא מומלץ לכלול בסמל טקסט או תוכן מותאם לשפה.

קובצי סמלים

הסמלים שמפנים אליהם בקובץ AchievementsIconMappings.csv צריכים להיות בארכיון ה-ZIP הנוכחי שמייבאים.

עריכת הישגים

אם כבר יש לכם הישגים קיימים ואתם רוצים לערוך אותם:

1. ב-Google Play Console, בוחרים משחק.
2. בדף שירותי המשחקים של Play – הישגים (צמיחה > שירותי המשחקים של Play > הגדרה וניהול > הישגים), בוחרים הישג.
3. אפשר לערוך את השדות.
4. לוחצים על שמירה כטיוטה.
5. בדף Play Games Services - Achievements, ההישג שעורכים נמצא בסטטוס 'זמין לבודקים'.
6. אחרי שבודקים את ההישג, לוחצים על בדיקה ופרסום.

   המשחק יפורסם מחדש, יחד עם כל ההישגים המעודכנים.

מחיקת הישג

אחרי פרסום ההישג, אי אפשר למחוק אותו. אפשר למחוק הישג רק במצב שלפני פרסום

1. בדף Play Games Services - Achievements (שירותי Play Games – הישגים), בוחרים הישג.
2. כדי למחוק את ההישג, לוחצים על מחיקת ההישג.

איפוס הישג

אפשר לאפס נתוני התקדמות של שחקנים רק לגבי הישגים במצב טיוטה.

1. בדף Play Games Services - Achievements (שירותי Play Games – הישגים), בוחרים הישג.
2. כדי לאפס את ההישגים, לוחצים על איפוס ההתקדמות.
3. כדי לאפס את נתוני ההישגים באופן פרוגרמטי, צריך להפעיל את השיטות של Management API Achievements.