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

יצירת הישג

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

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

ייבוא הישגים

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

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

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

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

1. ב-Google Play Console, בוחרים משחק.
2. בדף Play Games Services - הישגי (צמיחה > 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.

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

קובץ 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 Games Services – הישגים (צמיחה > Play Games Services > הגדרה וניהול > הישגים), בוחרים הישג.
3. אפשר לערוך את השדות.
4. לוחצים על שמירה כטיוטה.
5. בדף Play Games Services - הישגים, ההישג שעורכים נמצא בסטטוס "זמין לבודקים".
6. אחרי שבודקים את ההישג, לוחצים על בדיקה ופרסום.

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

מחיקת הישג

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

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

איפוס הישג

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

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