تابلوهای امتیازات می توانند راهی سرگرم کننده برای ایجاد رقابت در بین بازیکنان شما باشند، هم برای طرفداران سرسخت شما (که برای کسب رتبه برتر در جدول امتیازات عمومی مبارزه می کنند) و هم برای بازیکنان معمولی تر شما (که علاقه مند به مقایسه پیشرفت خود با آنها هستند. دوستان').
برای یادگیری نحوه پیاده سازی تابلوهای امتیازات برای پلتفرم خود، به پیاده سازی های مشتری مراجعه کنید.
درک تابلوهای امتیازات
وقتی تابلوی امتیازات ایجاد می‌کنید، سرویس‌های بازی‌های Google Play مدیریت بیشتر جنبه‌های این تابلوی امتیازات را برای شما به عهده خواهند گرفت. روند معمولی به این صورت عمل می کند:
- در پایان یک بازی (یا در یک لحظه مناسب که شما تعیین کرده اید)، بازی امتیاز بازیکن را به یک یا چند تابلوی امتیازات که برای بازی ایجاد کرده اید ارسال می کند.
- خدمات بازی‌های Google Play بررسی می‌کند که آیا این امتیاز بهتر از ورودی امتیازات فعلی بازیکن برای امتیاز روزانه، هفتگی یا تمام وقت است. اگر اینطور باشد، خدمات بازی های Google Play تابلوهای امتیازات مربوطه را با امتیاز جدید به روز می کند.
- خدمات بازی‌های Google Play یک گزارش امتیاز را به مشتری بازی ارسال می‌کند. این گزارش به مشتری می‌گوید که آیا این یک امتیاز بالاتر روزانه، هفتگی یا تمام دوران است. اگر اینطور نیست، سرویس‌های بازی‌های Google Play به مشتری می‌گویند که امتیاز بالای روزانه، هفتگی یا همیشه برای این بازیکن چقدر است.
- برای بازیابی نتایج یک بازیکن برای تابلوی امتیازات، می‌توانید یک بازه زمانی (روزانه، هفتگی یا تمام وقت) درخواست کنید و مشخص کنید که آیا کاربر می‌خواهد تابلوی امتیازات اجتماعی یا عمومی را ببیند یا خیر. سرویس Games تمام فیلترهای لازم را انجام می دهد و سپس نتایج را برای مشتری ارسال می کند.
- در مواردی که امتیازهای زیادی برای گزارش وجود دارد، سرویس Games فقط داده‌های امتیازات برتر جدول امتیازات را پس می‌فرستد. همچنین می‌توانید داده‌های امتیاز خام را برای امتیازات برتر یا امتیازهای مجاور بازیکن بازیابی کنید.
تابلوهای امتیازات متعدد
بازی‌ها می‌توانند چندین تابلوی امتیاز، حداکثر تا 70 داشته باشند. برای مثال، یک بازی چند سطحی ممکن است برای هر سطح، تابلوی امتیازات متفاوتی ارائه کند، و یک بازی مسابقه‌ای ممکن است یک تابلوی امتیاز جداگانه برای هر مسیر داشته باشد.
فریم های زمانی تابلوی برتر
کیت توسعه نرم‌افزار Play Games به‌طور خودکار نسخه‌های روزانه، هفتگی، و همیشه از هر تابلوی امتیازاتی که ایجاد می‌کنید ایجاد می‌کند. نیازی به ایجاد تابلوهای امتیازات جداگانه برای هر بازه زمانی وجود ندارد.
تابلوهای امتیازات روزانه در UTC-7 (یعنی "نیمه شب به وقت روز اقیانوس آرام") در تمام طول سال بازنشانی می شوند.
تابلوهای امتیازات هفتگی در نیمه شب بین شنبه و یکشنبه، در همان منطقه زمانی تابلوهای امتیازات روزانه (UTC-7) بازنشانی می‌شوند.
تابلوهای عمومی و اجتماعی
SDK بازی‌های Play می‌تواند دو نسخه مختلف از هر تابلوی امتیازات را به بازیکن نمایش دهد:
تابلوی امتیازات اجتماعی یک تابلوی امتیازات متشکل از افرادی در حلقه های کاربر (یا به طور دقیق تر، اعضای حلقه هایی است که کاربر برای اشتراک گذاری با برنامه شما انتخاب کرده است) که تصمیم گرفته اند فعالیت بازی خود را با کاربر به اشتراک بگذارند.
تابلوی امتیازات عمومی ، تابلوی امتیازاتی است که از بازیکنانی تشکیل شده است که تصمیم گرفته اند فعالیت بازی خود را به صورت عمومی به اشتراک بگذارند. اگر بازیکن شما انتخاب نکرده است که فعالیت بازی خود را به صورت عمومی به اشتراک بگذارد، در این تابلوی امتیازات ظاهر نمی‌شود.
نمایش تابلوهای امتیازات
در کتابخانه های مشتری سیار، کتابخانه ها از تمام قالب بندی و نمایش تابلوهای امتیازات مراقبت می کنند. می‌توانید تعیین کنید که آیا یک بازیکن می‌تواند یک تابلوی امتیازات خاص را ببیند یا فهرستی از تمام تابلوهای امتیازات شما را که می‌تواند از بین آنها انتخاب کند، مشاهده کند.
شما همچنین می توانید نسخه های خود از تابلوهای امتیازات را با دسترسی مستقیم به داده ها از کتابخانه های مشتری پیاده سازی کنید.
ویژگی های
برای ایجاد و مدیریت تابلوهای امتیازات، باید با این ویژگی‌های تابلوی امتیازات آشنا شوید:
اصول اولیه
این عناصر اساسی با هر تابلوی امتیازات مرتبط است:
- ID یک رشته منحصر به فرد است که کنسول Google Play برای شما ایجاد می کند. شما از این شناسه منحصربفرد برای مراجعه به تابلوی امتیازات در مشتریان بازی خود استفاده خواهید کرد.
- Name نام کوتاهی از تابلوی امتیازات است (به عنوان مثال، "امتیازات بالا" یا "سطح 3"). این می تواند تا 100 کاراکتر باشد.
- نماد یک نماد مربع است که با تابلوی امتیازات شما مرتبط می شود. برای بهترین روش‌ها هنگام ایجاد نمادهای تابلوی امتیازات، بخش دستورالعمل‌های نماد را در زیر ببینید.
- ترتیب فهرست به ترتیبی گفته می شود که وقتی بازیکنی تابلوهای امتیازات مرتبط با بازی شما را مشاهده می کند، تابلوی امتیازات ظاهر می شود.
- محدودیت ها مقادیر اختیاری هستند که حد پایین و بالای امتیازات مجاز در تابلوی امتیازات را مشخص می کنند. این می تواند به شما کمک کند که امتیازات ارسالی را که به وضوح تقلبی هستند کنار بگذارید. همچنین می‌توانید از
Players.hideبرای پنهان کردن بازیکنانی که فکر می‌کنید امتیازات جعلی را از همه تابلوهای امتیازات در برنامه شما ارسال کرده‌اند، استفاده کنید.
مرتب سازی
تابلوهای امتیازات می توانند یکی از دو نوع سفارش را داشته باشند:
- تابلوهای امتیازات بزرگتر بهتر است پیش فرض هستند. این چیزی است که معمولاً در اکثر بازی‌هایی که بازیکنان امتیاز کسب می‌کنند، می‌بینید.
- تابلوهای امتیازات کوچکتر بهتر گهگاه در مواردی که امتیاز کمتر بهتر است استفاده می شود. رایج‌ترین نمونه‌های این نوع تابلوی امتیازات در بازی‌های مسابقه‌ای است که امتیاز نشان‌دهنده زمان بازیکن برای به پایان رساندن مسابقه است.
قالب بندی امتیاز
در حالی که تمام امتیازات به تابلوی امتیازات ارسال می‌شوند و به صورت داخلی به صورت اعداد صحیح طولانی ذخیره می‌شوند، سرویس بازی‌ها می‌تواند آنها را در قالب‌های مختلف به کاربر ارائه کند:
تابلوهای امتیازات عددی نمرات را به عنوان اعداد نشان می دهند. اینها را می توان به صورت اعداد صحیح یا اعداد واقعی با تعداد ثابت اعشار نمایش داد. شما امتیاز را به صورت اعداد صحیح ارسال می کنید و اعشار در محل مشخص شده درج می شود. برای مثال، بسته به رقم اعشاری که مشخص کرده‌اید، امتیاز
314159به صورت3.14159،3141.59یا314159نمایش داده می‌شود.تابلوهای امتیازات زمانی نمرات را در قالب ساعت / دقیقه / ثانیه / صدم ثانیه ارائه می دهند. شما باید امتیازها را به صورت میلی ثانیه ارسال کنید، بنابراین
66032به عنوان1:06.03تفسیر می شود.تابلوهای امتیازات ارزها امتیازات را در قالب ارز ارائه می کنند. شما امتیازات را به عنوان 1/1,000,000 واحد پول اصلی ارسال می کنید. به عنوان مثال، با فرض اینکه واحد پول خود را USD مشخص کرده باشید، امتیاز 19,950,000 به عنوان
$19.95تفسیر می شود.
تابلوهای امتیازات عددی از واحدهای سفارشی نیز پشتیبانی می کنند. به عنوان مثال، اگر بازی شما امتیازات بالا را بر حسب متر اندازه گیری می کند، می توانید "متر" را به عنوان واحد پیش فرض برای تابلوی امتیازات خود تعیین کنید.
ترجمه ها و قالب بندی نمرات
هنگامی که کتابخانه های سرویس گیرنده موبایل داده های تابلوی امتیازات را از سرویس بازی ها درخواست می کنند، زبان و محلی را برای نمایش این امتیازها مشخص می کنند. REST API به شما امکان می دهد یک زبان مبتنی بر محلی را نیز مشخص کنید. سرویس بازی‌ها نمرات جدول امتیازات قالب‌بندی شده مناسب برای آن زبان و منطقه را برمی‌گرداند. این امتیازات قالب‌بندی شده ظاهر می‌شوند چه ترجمه‌هایی را برای تابلوی امتیازات خود اضافه کرده باشید یا نه.
برای تابلوهای امتیازات عددی ، قالب اعداد در هر زبان متفاوت نمایش داده می شود. (به عنوان مثال، 12,345.78 در ایالات متحده، و 12 345,78 در فرانسه.) اگر از واحدهای سفارشی استفاده می کنید و ترجمه هایی را به بازی خود اضافه کرده اید، باید واحدهای ترجمه شده را برای هر زبانی که اضافه کرده اید ارائه کنید. سپس سرویس این واحدهای ترجمه شده را در صورت لزوم نمایش می دهد.
بسته به زبانی که انتخاب می کنید، ممکن است لازم باشد نسخه های مختلفی از نام واحدهای خود را ارائه دهید. در زبان انگلیسی برای یک مورد به یک نسخه و برای هر چیز دیگری (به عنوان مثال، متر و متر) نیاز دارید. از سوی دیگر، در زبان لهستانی، باید نسخه ای برای یک واحد، چند واحد، تعداد زیادی واحد و هر چیز دیگری ارائه دهید. برای کسب اطلاعات بیشتر در مورد قوانین جمع، به رشته های کمیت (جمع) مراجعه کنید.
برای تابلوهای امتیازات زمان ، قالب زمان با توجه به زبان و محل پخش کننده نمایش داده می شود. اگر از کسری از ثانیه استفاده می کنید یا مقدار ساعت با بیش از 3 رقم (به عنوان مثال، 4,815:16:23.42 در ایالات متحده و 4.815:16:23,42 در آلمان) استفاده می کنید، عمدتاً قابل توجه خواهد بود.
برای تابلوهای امتیازات ارز ، فرمت ارز مطابق با زبان و زبان پخش کننده نمایش داده می شود. با این حال، شما نمی توانید واحد پول را تغییر دهید. به عنوان مثال، اگر ارز خود را به USD مشخص کنید، بازی $19.95 در ایالات متحده و 19,95 $ در فرانسه نمایش داده می شود. اما نمی توانید مشخص کنید که بازی شما دلار آمریکا و یورو در فرانسه را نشان دهد.
دستورالعمل های آیکون
آیکون ها باید به صورت فایل های PNG یا JPEG با ابعاد 512 x 512 ایجاد شوند. آیکون‌های شما در اکثر کلاینت‌های بازی کوچک می‌شوند، بنابراین باید از ایجاد آیکون‌هایی با جزئیات زیاد اجتناب کنید. می توانید نمادها را با یک کانال آلفا ارسال کنید و شفافیت حفظ خواهد شد. نماد تابلوی امتیازات در یک پس‌زمینه خاکستری تیره‌تر در دستگاه‌های Android نشان داده می‌شود، بنابراین نمادی را انتخاب کنید که در این شرایط به خوبی کار کند.
نماد یکسان در همه زبان‌ها استفاده می‌شود، بنابراین توصیه می‌کنیم از گنجاندن متن یا محتوای بومی‌سازی شده در یک نماد خودداری کنید.
یک تابلوی امتیازات ایجاد کنید
این بخش به شما می گوید که چگونه برای بازی های جدید یا موجود تابلوهای امتیاز ایجاد کنید.
یک تابلوی امتیازات برای یک بازی جدید ایجاد کنید
برای ایجاد تابلوی امتیازات برای یک بازی جدید و منتشر نشده، به ورودی کنسول Google Play برای بازی خود بروید و به Grow > Play Games Services > Setup and management > Leaderboards بروید، سپس روی دکمه ایجاد تابلوی امتیازات کلیک کنید.
سپس، به سادگی اطلاعات مورد نیاز برای این تابلوی امتیازات را پر کنید.
روی ذخیره به عنوان پیش نویس کلیک کنید و تابلوی امتیازات شما در حالت "پیش نویس" در دسترس خواهد بود. هنگامی که بازی خود را منتشر می کنید، تمام جدول امتیازات بازی شما با آن منتشر می شود.
یک تابلوی امتیازات برای یک بازی منتشر شده ایجاد کنید
برای ایجاد تابلوی امتیازات اضافی برای یک بازی که قبلاً منتشر شده است، همان مراحل بالا را دنبال کنید. برای اطلاعات بیشتر در مورد آزمایش نسخه به روز شده یک بازی، به انتشار تغییرات بازی خود مراجعه کنید.
هنگامی که تابلوی امتیازات خود را آزمایش کردید و از آن راضی بودید، می‌توانید بازی خود را با تابلوهای امتیازات جدید مجدداً منتشر کنید و آنها به جهان عرضه خواهند شد.
تابلوی امتیازات را ویرایش کنید
برای ویرایش تابلوی امتیازاتی که قبلاً ایجاد کرده‌اید، روی تابلوی امتیازات در برگه تابلوهای امتیازات کنسول Google Play کلیک کنید. در این مرحله، همان فرمی را می بینید که هنگام ایجاد تابلوی امتیازات برای اولین بار استفاده کردید و می توانید هر یک از فیلدها را به دلخواه خود ویرایش کنید.
وقتی ویرایش تابلوی امتیازات را تمام کردید، روی دکمه ذخیره به عنوان پیش نویس کلیک کنید. تابلوی امتیازات تازه ویرایش شده در حالت "پیش نویس" خواهد بود که به شما امکان می دهد آن را آزمایش کنید.
اگر به درستی کار می کند، انتشار تغییرات را از کادر بالای فرم امتیازات انتخاب کنید و می توانید بازی خود را به همراه تمام تابلوهای امتیازات به روز شده خود برای عموم منتشر کنید.
لغو یک ویرایش
اگر تصمیم دارید تابلوی امتیازات تازه ویرایش شده خود را دوست ندارید و می خواهید به تکرار قبلی برگردید، به سادگی از کادر بالای فرم تابلوی امتیازات، Revert را انتخاب کنید. تابلوی امتیازات شما به نسخه از قبل منتشر شده برمی گردد.
حذف تابلوی امتیازات
می‌توانید تابلوهای امتیازاتی را که در حالت «پیش‌نویس» هستند یا منتشر شده‌اند حذف کنید. برای حذف تابلوی امتیازات در کنسول Google Play، به فرم تابلوی امتیازات بروید و روی حذف تابلوی امتیازات در بالای فرم کلیک کنید.
از طرف دیگر، می‌توانید با Players.hide تماس بگیرید تا تابلوی امتیازات بازیکن در برنامه پنهان شود.
یک تابلوی امتیازات را بازنشانی کنید
فقط می‌توانید داده‌های پیشرفت بازیکن را برای تابلوهای امتیازات پیش‌نویس خود بازنشانی کنید.
- برای بازنشانی تابلوهای امتیازات در کنسول Google Play، روی بازنشانی پیشرفت در بالای فرم مربوط به آن رویداد کلیک کنید.
- برای بازنشانی داده‌های تابلوی امتیازات از طریق برنامه‌ریزی، با روش‌های
Scoresمدیریت API تماس بگیرید.
ترجمه برای تابلوهای امتیازات اضافه کنید
می توانید ترجمه های خود را برای تابلوهای امتیازاتی که با بازی شما مرتبط هستند مشخص کنید. قبل از انجام این کار، ابتدا مطمئن شوید که مراحل توضیح داده شده در افزودن ترجمه برای بازی خود را کامل کرده اید. همچنین باید یک یا چند تابلوی امتیازات برای بازی خود ایجاد کرده باشید.
برای افزودن ترجمه‌های خود برای تابلوهای امتیازات، برگه تابلوهای امتیازات را برای بازی خود در کنسول Google Play باز کنید، سپس تابلوی امتیازات موجود را انتخاب کنید. در صفحه جزئیات تابلوی امتیازات، روی زبانه زبانی که قبلاً در برگه جزئیات بازی اضافه کرده‌اید، کلیک کنید. در صفحه جزئیات تابلوی امتیازات برای آن زبان، فرم را با ترجمه های خود برای آن تابلوی امتیازات ویرایش کنید. برای ذخیره جزئیات تابلوی امتیازات ترجمه شده خود، روی ذخیره کلیک کنید.
مخفی کردن امتیازات تابلوی امتیازات
خدمات بازی‌های Google Play یک ویژگی حفاظت از دستکاری تابلوی امتیازات ارائه می‌کند که نمرات مشکوک به دستکاری شده را بررسی می‌کند و آنها را به‌طور خودکار پنهان می‌کند. این ویژگی فقط برای بازی های اندروید در دسترس است.
حفاظت از دستکاری به طور پیش‌فرض برای تابلوهای امتیازات جدیدی که برای بازی اندروید خود ایجاد می‌کنید فعال است، اما برای تابلوهای امتیازات موجود غیرفعال است. برای فعال کردن محافظت از دستکاری برای تابلوهای امتیازات موجود خود که قبلاً منتشر شده‌اند، این مراحل را دنبال کنید:
- در Google Play Console، تب Games Services را باز کنید، سپس بازی خود را از لیست انتخاب کنید.
- برگه تابلوهای امتیازات را باز کنید، سپس نمونه تابلوی امتیازات را که می‌خواهید محافظت از دستکاری را برای آن فعال کنید، انتخاب کنید.
- گزینه Enable leaderboard tamper protection را روی ON قرار دهید.
- روی ذخیره کلیک کنید و ادامه دهید.
- بازی خود را منتشر کنید
هنگامی که حفاظت از دستکاری برای تابلوی امتیازات در کنسول Google Play فعال شود، ممکن است تا 24 ساعت طول بکشد تا این ویژگی اعمال شود. امتیازهایی که قبل از فعال کردن محافظت از دستکاری ارسال شده اند به طور ماسبق پنهان نمی شوند.
در برخی شرایط، ممکن است بخواهید حفاظت از دستکاری را غیرفعال کنید (به عنوان مثال، اگر بازی شما علاوه بر اندروید در وب نیز اجرا می شود و تابلوهای امتیازات را در این پلتفرم ها به اشتراک می گذارد).
پیاده سازی های مشتری
برای یادگیری نحوه اجرای تابلوهای امتیازات برای پلتفرم خود، به منابع زیر مراجعه کنید: