دستاوردها

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

ارسال بازخورد

دستاوردها می توانند راهی عالی برای افزایش تعامل کاربران در بازی شما باشند. می‌توانید دستاوردهایی را در بازی خود پیاده کنید تا بازیکنان را تشویق کنید تا ویژگی‌هایی را که معمولاً از آن‌ها استفاده نمی‌کنند آزمایش کنند یا با سبک‌های بازی کاملاً متفاوت به بازی خود نزدیک شوند. دستاوردها همچنین می تواند راهی سرگرم کننده برای بازیکنان باشد تا پیشرفت خود را با یکدیگر مقایسه کنند و در رقابتی ساده شرکت کنند.

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

صفات

برای درک نحوه عملکرد دستاوردها، باید با برخی از ویژگی های مرتبط با آنها آشنا شوید.

این عناصر اساسی با هر دستاوردی مرتبط هستند:

• شناسه یک رشته منحصر به فرد است که توسط کنسول Google Play تولید می شود. شما از این شناسه منحصر به فرد برای اشاره به دستاورد در مشتریان بازی خود استفاده خواهید کرد.
• Name نام کوتاهی از دستاورد است (به عنوان مثال، "Pieman"). مقدار می تواند تا 100 کاراکتر باشد.
• توضیحات شرح مختصری در مورد دستاورد شما است. معمولاً این به بازیکن شما می‌گوید که چگونه می‌تواند این دستاورد را کسب کند (به عنوان مثال، «قبل از غروب آفتاب یک پای مرنگ لیمو بپزید»). مقدار می تواند تا 500 کاراکتر باشد.
• نماد یک نماد مربع است که با دستاورد شما مرتبط است. برای بهترین روش ها هنگام ایجاد نمادهای دستاورد خود، به بخش دستورالعمل های نماد مراجعه کنید.
• ترتیب فهرست ، ترتیبی است که با مشاهده دستاوردهای مرتبط با بازی شما، دستاوردهای قفل شده ظاهر می شوند. این می تواند به هر ترتیبی که دوست دارید باشد. دستاوردهای قفل نشده به ترتیب به دست آمده در بالای لیست ظاهر می شوند.

ایالت

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

• یک دستاورد پنهان به این معنی است که جزئیات مربوط به دستاورد از بازیکن پنهان است. «خدمات بازی‌های Play» یک توضیح و نماد کلی مکان‌نما برای دستاورد در حالی که در حالت پنهان است، ارائه می‌کند. توصیه می‌کنیم اگر دستاوردی حاوی اسپویلری باشد که نمی‌خواهید خیلی زود درباره بازی‌تان فاش کنید، آن را پنهان کنید (مثلاً «کشف کنید که همیشه یک روح بوده‌اید!»).
• دستاورد فاش شده به این معنی است که بازیکن از دستاورد مطلع است، اما هنوز آن را به دست نیاورده است. اکثر دستاوردها در حالت آشکار شروع می شوند.
• اچیومنت قفل نشده به این معنی است که بازیکن با موفقیت این دستاورد را کسب کرده است. یک دستاورد را می توان به صورت آفلاین باز کرد. وقتی بازی آنلاین می‌شود، با خدمات بازی‌های Play همگام‌سازی می‌شود تا حالت قفل آن به‌روزرسانی شود.

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

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

سرویس Google Play اطلاعات پیشرفت را پیگیری می‌کند، زمانی که بازیکن معیارهای لازم برای باز کردن قفل آن دستاورد را برآورده کرده است، به بازی هشدار می‌دهد و به بازیکن می‌گوید که تا چه حد برای رسیدن به آن هدف فاصله دارد.

دستاوردهای افزایشی در طول جلسات بازی انباشته می شوند و پیشرفت را نمی توان از داخل بازی حذف یا بازنشانی کرد. به عنوان مثال، "برنده شدن در 50 بازی" به عنوان یک دستاورد افزایشی واجد شرایط است. "برنده شدن در 3 بازی متوالی" انجام نمی شود، زیرا پیشرفت بازیکن در صورت شکست در یک بازی بازنشانی می شود. "دارای 5000 تراشه پوکر" نیز واجد شرایط نیست، زیرا یک بازیکن می‌تواند در حین بازی، تراشه‌ها را به دست آورد یا از دست بدهد. برای دو دستاورد آخر، این به شما بستگی دارد که وضعیت "پیروزی های متوالی" یا مجموع تراشه های بازیکن را ردیابی کنید و زمانی که بازیکن آنها را به دست آورد، قفل دستاوردهای استاندارد را باز کنید.

هنگام ایجاد یک دستاورد افزایشی، باید تعداد کل مراحل لازم برای باز کردن قفل آن را مشخص کنید (این عدد باید بین 2 تا 10000 باشد). همانطور که کاربر به سمت باز کردن قفل دستاورد پیشرفت می کند، باید تعداد مراحل اضافی را که کاربر انجام داده است به خدمات بازی های Play گزارش دهید. هنگامی که تعداد کل مراحل به مقدار باز کردن قفل رسید، دستاورد باز می شود (حتی اگر پنهان باشد). نیازی به ذخیره پیشرفت تجمعی کاربر نیست.

امتیاز

دستاوردها دارای یک ارزش امتیاز مرتبط با آنها هستند. امتیاز بازیکن باید مضربی از 5 باشد و یک بازی هرگز نمی تواند در مجموع بیش از 1000 امتیاز برای تمام دستاوردهای خود داشته باشد (اگرچه می تواند کمتر باشد). علاوه بر این، هیچ دستاوردی نمی تواند بیش از 200 امتیاز داشته باشد.

ردیابی امتیاز تجربه (XP)

وقتی بازیکنان در بازی‌های فعال‌شده «بازی‌های Play» دستاوردهایی کسب می‌کنند، می‌توانند سطوحی را در نمایه بازی خود کسب کنند. به ازای هر امتیاز مرتبط با یک دستاورد، بازیکن با کسب آن دستاورد، 100 امتیاز تجربه (XP) به دست می‌آورد. به عبارت دیگر:

XP for an achievement = 100 * (point value for the achievement)

سرویس‌های بازی‌های Play XP کسب‌شده توسط هر بازیکن را ردیابی می‌کنند و زمانی که بازیکن امتیاز کافی برای «سطح بالا» کسب کرده است، اعلانی به برنامه «بازی‌های Google Play» ارسال می‌کند. بازیکنان می توانند سطح و سابقه XP خود را از صفحه نمایه خود در برنامه بازی های Google Play مشاهده کنند.

حداقل دستاوردها

یک بازی که دستاوردها را ادغام می کند باید حداقل پنج دستاورد قبل از انتشار داشته باشد. می توانید با کمتر از پنج دستاورد آزمایش کنید، اما توصیه می شود قبل از انتشار بازی خود حداقل پنج دستاورد ایجاد کنید.

حداکثر دستاوردها

تعداد دستاوردها با محدودیت امتیاز و توزیع محدود شده است. با حداکثر تعداد امتیاز 1000، و هر دستاورد 5 امتیاز، حداکثر تعداد دستاوردها 200 است. اما، اگر به دستاوردها امتیاز بیشتری اختصاص داده شود، در نتیجه تعداد دستاوردهای موجود کاهش می یابد.

افزودن دستاوردها

دو راه برای ایجاد دستاوردها برای اولین بار با استفاده از کنسول Google Play وجود دارد:

• ایجاد یک دستاورد : تعاریف و ابرداده را برای هر دستاورد یکی یکی اضافه کنید.
• دستاوردهای وارد کردن : تعاریف و سایر ابرداده‌ها را برای چندین دستاورد با هم در یک مرحله وارد کنید.

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

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

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

دستاوردهای بیشتری اضافه کنید

اگر از قبل دستاوردهای موجود دارید و می خواهید موارد بیشتری اضافه کنید:

1. در کنسول Google Play ، یک بازی را انتخاب کنید.
2. در صفحه خدمات بازی های Play - دستاوردها ( رشد > خدمات بازی های Play > راه اندازی و مدیریت > دستاوردها )، افزودن دستاوردها را انتخاب کنید.

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

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

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

برای اطلاعات بیشتر در مورد فایل فشرده، دستورالعمل های فایل فشرده را ببینید.

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

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

بازی خود را منتشر کنید

هنگامی که بازی خود را آزمایش و منتشر کردید ، تمام دستاوردهای بازی شما با آن منتشر می شود.

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

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

پس از اتمام ویرایش یک دستاورد، روی دکمه ذخیره به عنوان پیش نویس کلیک کنید. دستاورد تازه ویرایش شده در مرحله "آماده برای آزمایش" خواهد بود و شما می توانید آن را آزمایش کنید. اگر درست کار می کند، از لیست کشویی Republish را انتخاب کنید. این بازی شما را به همراه تمام دستاوردهای به روز شده شما برای عموم منتشر می کند.

لغو یک ویرایش

اگر تصمیم گرفتید که دستاورد فعلی خود را دوست ندارید و می‌خواهید به دستاورد خود بازگردید، از فهرست کشویی در کنسول Google Play، Revert را انتخاب کنید و همه دستاوردهای شما به نسخه منتشر شده قبلی برمی‌گردند.

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

هنگامی که دستاورد شما منتشر شد، نمی توان آن را حذف کرد.

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

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

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

• برای بازنشانی دستاوردها در کنسول Google Play، روی دکمه بازنشانی پیشرفت دستاورد در پایین فرم مربوط به آن رویداد کلیک کنید.
• برای بازنشانی داده‌های دستاورد به صورت برنامه‌ریزی، روش‌های مدیریت API Achievements را فراخوانی کنید.

دستورالعمل های آیکون

نمادها باید به صورت فایل های PNG، JPEG یا JPG با ابعاد 512 x 512 ایجاد شوند. شما فقط باید نماد دستاورد باز شده را در اختیار ما قرار دهید. ما یک نسخه خاکستری برای نماد آشکار شده به طور خودکار تولید می کنیم. به همین دلیل، توصیه می‌کنیم نمادهای دستاورد شما شامل عناصر رنگارنگ باشد، بنابراین کاربران شما می‌توانند بین دستاوردهای آشکار و قفل نشده تمایز قفل کنند.

هنگامی که یک نماد دستاورد در یک نان تست اندروید نمایش داده می شود، نماد با یک دایره پوشانده می شود و گوشه های بیرونی آن پنهان می شود. مطمئن شوید که نماد شما همچنان در این شرایط خوب به نظر می رسد.

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

دستورالعمل های فایل فشرده

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

الزامات فایل فشرده:

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

فرمت 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

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

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

ترجمه برای دستاوردها اضافه کنید

شما می توانید ترجمه های خود را برای دستاوردهایی که با بازی شما مرتبط هستند مشخص کنید. قبل از انجام این کار، ابتدا مطمئن شوید که مراحل توضیح داده شده در افزودن ترجمه برای بازی خود را کامل کرده اید.

دو روش برای اضافه کردن ترجمه برای بازی خود وجود دارد:

• می توانید از گزینه واردات دستاوردها برای آپلود ترجمه برای بسیاری از دستاوردهای جدید به طور همزمان استفاده کنید. نمی‌توانید از این گزینه برای بارگذاری ترجمه‌های دستاوردهای موجود استفاده کنید.

• می توانید برای هر دستاورد در بازی خود ترجمه اضافه کنید. برای افزودن ترجمه خود برای هر دستاورد:

  1. در کنسول Google Play، تب Achievements را برای بازی خود باز کنید، سپس یک دستاورد موجود را انتخاب کنید.
  2. در صفحه جزئیات دستاوردها، برگه زبانی را که قبلاً در برگه جزئیات بازی اضافه کرده‌اید، انتخاب کنید.
  3. در صفحه جزئیات دستاورد برای آن زبان، فرم را با ترجمه های خود برای آن دستاورد ویرایش کنید.
  4. برای ذخیره جزئیات دستاورد ترجمه شده خود، روی ذخیره کلیک کنید.

پیاده سازی های مشتری

برای یادگیری نحوه پیاده سازی دستاوردها برای پلتفرم خود، به منابع زیر مراجعه کنید:

• اندروید
• وحدت
• وب
• بهترین شیوه ها برای اجرای دستاوردها