دستاوردها را یکپارچه کنید، دستاوردها را یکپارچه کنید

یک دستاورد ایجاد کنید

برای ایجاد یک دستاورد برای یک بازی جدید و منتشر نشده، این مراحل را دنبال کنید:

1. در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
2. در صفحه «خدمات بازی‌های Play - دستاوردها» ( رشد > خدمات بازی‌های Play > راه‌اندازی و مدیریت > دستاوردها )، «ایجاد دستاورد» را انتخاب کنید.
3. در صفحه افزودن دستاوردها ، فرم را تکمیل کنید.
4. روی ذخیره به عنوان پیش‌نویس کلیک کنید.
5. پس از ایجاد یک دستاورد، باید دستاوردهای خود را منتشر کنید .

دستاوردهای واردات

برای اضافه کردن چندین دستاورد به طور همزمان به بازی خود، مراحل زیر را دنبال کنید:

1. یک فایل زیپ حاوی دستاوردهای خود ایجاد کنید.
2. فایل را آپلود کنید.

برای اطلاعات بیشتر در مورد فایل زیپ، به دستورالعمل‌های فایل زیپ مراجعه کنید.

برای وارد کردن دستاوردها:

1. در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
2. در صفحه خدمات بازی‌های Play - دستاوردها ( رشد > خدمات بازی‌های Play > راه‌اندازی و مدیریت > دستاوردها )، وارد کردن دستاوردها را انتخاب کنید.
3. در صفحه وارد کردن دستاوردها ، روی بارگذاری کلیک کنید.
4. فایل زیپ را برای آپلود انتخاب کنید.
5. روی ذخیره به عنوان پیش‌نویس کلیک کنید.
6. بعد از اینکه دستاوردها را وارد کردید، باید بازی خود را منتشر کنید .

دستورالعمل‌های فایل زیپ

شما می‌توانید چندین دستاورد را به طور همزمان با استفاده از یک فایل زیپ وارد کنید. برای نام دقیق فایل‌هایی که باید در فایل زیپ خود استفاده کنید، به جدول مراجعه کنید:

الزامات فایل زیپ:

• بدون زیرشاخه.
• نام فایل‌های منحصر به فرد.
• فقط فایل‌های CSV، PNG، JPEG یا JPG.
• فایل‌های CSV نباید ردیف سربرگ داشته باشند.
• هر فایل باید زیر ۱ مگابایت باشد.
• فایل زیپ نباید بیش از 203 فایل داشته باشد.
• حجم کل فایل‌های فشرده باید کمتر از ۲۰۰ مگابایت باشد.

فرمت 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 می‌تواند برای fr-FR نیز "Achievement1" نامگذاری شود.

• هر ردیف باید چهار مقدار داشته باشد. اگر می‌خواهید مقدار توضیحات محلی‌شده را حذف کنید، آن را خالی بگذارید.

یک نمونه فایل 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 با ابعاد ۵۱۲ در ۵۱۲ پیکسل ایجاد شوند. شما فقط باید آیکون مربوط به دستاورد قفل‌گشایی‌شده را در اختیار ما قرار دهید. ما به طور خودکار یک نسخه خاکستری از آیکون آشکارشده تولید خواهیم کرد. به همین دلیل، توصیه می‌کنیم آیکون‌های دستاورد شما شامل عناصر رنگی باشند تا کاربران بتوانند بین دستاوردهای آشکارشده و قفل‌گشایی‌شده تمایز قائل شوند.

وقتی یک آیکون دستاورد در [toast][a] اندروید نمایش داده می‌شود، آیکون با یک دایره پوشانده شده و گوشه‌های بیرونی آن پنهان می‌شوند. مطمئن شوید که آیکون شما در این شرایط همچنان خوب به نظر می‌رسد.

از یک آیکون در همه زبان‌ها استفاده می‌شود، بنابراین توصیه می‌کنیم از قرار دادن هرگونه متن یا محتوای بومی‌سازی‌شده در یک آیکون خودداری کنید.

فایل‌های آیکون

آیکون‌هایی که در فایل AchievementsIconMappings.csv به آن‌ها ارجاع می‌دهید، باید در فایل فشرده‌ی فعلی که وارد می‌کنید، وجود داشته باشند.

ویرایش دستاوردها

اگر از قبل دستاوردهایی دارید و می‌خواهید آنها را ویرایش کنید:

1. در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
2. در صفحه «خدمات بازی‌های Play - دستاوردها» ( رشد > خدمات بازی‌های Play > راه‌اندازی و مدیریت > دستاوردها )، یک دستاورد را انتخاب کنید.
3. شما می‌توانید هر یک از فیلدها را ویرایش کنید.
4. روی ذخیره به عنوان پیش‌نویس کلیک کنید.
5. در صفحه « خدمات بازی‌های Play - دستاوردها» ، دستاورد ویرایش‌شده در وضعیت «در دسترس آزمایش‌کنندگان» قرار دارد.
6. پس از آزمایش دستاورد، روی «بررسی و انتشار» کلیک کنید.

   این کار بازی شما را به همراه تمام دستاوردهای به‌روزرسانی‌شده‌تان دوباره منتشر می‌کند.

حذف یک دستاورد

وقتی دستاورد شما منتشر شد، دیگر نمی‌توانید آن را حذف کنید. فقط می‌توانید یک دستاورد را در حالت از پیش منتشر شده حذف کنید.

1. در صفحه «خدمات بازی‌های Play - دستاوردها» ، یک دستاورد را انتخاب کنید.
2. برای حذف دستاورد، روی حذف دستاورد کلیک کنید.

بازنشانی یک دستاورد

شما فقط می‌توانید داده‌های پیشرفت بازیکن را برای دستاوردهای پیش‌نویس خود بازنشانی کنید.

1. در صفحه «خدمات بازی‌های Play - دستاوردها» ، یک دستاورد را انتخاب کنید.
2. برای بازنشانی دستاوردها، روی «بازنشانی پیشرفت» کلیک کنید.
3. برای تنظیم مجدد داده‌های دستاوردها به صورت برنامه‌نویسی شده، متدهای Achievements از API مدیریت را فراخوانی کنید.