در این صفحه نحوه راه اندازی سرویس های بازی های Google Play برای بازی اندروید خود با استفاده از کنسول Google Play توضیح داده شده است. کنسول Play مکانی متمرکز برای مدیریت سرویسهای بازی و پیکربندی فرادادههای مورد استفاده برای تأیید و احراز هویت بازی شما فراهم میکند.
برای افزودن بازی خود به Play Console، این مراحل کلی را دنبال کنید:
یک پروژه بازی برای بازی خود ایجاد کنید و جزئیاتی مانند نام و توضیحات بازی را مشخص کنید.
اعتبارنامههای لازم برای تأیید و تأیید اعتبار بازی خود را به خدمات بازیهای Google Play ایجاد و پیوند دهید.
قبل از شروع
قبل از پیکربندی خدمات بازی های Google Play، مراحل زیر را کامل کنید.
یک حساب توسعه دهنده Google Play ایجاد کنید
شما باید یک حساب برنامهنویس Google Play در Play Console راهاندازی کرده باشید. برای اطلاعات بیشتر، به ثبت نام برای یک حساب برنامهنویس Google Play مراجعه کنید.
اعطای مجوز ویرایش: برای ویرایش تنظیمات خدمات بازیهای Play در کنسول Play، تیم شما باید مجوزهایی برای مدیریت خدمات بازیهای Play داشته باشد. برای اطلاعات بیشتر، به افزودن کاربران حساب برنامهنویس و مدیریت مجوزها مراجعه کنید.
یک پروژه Google Cloud ایجاد کنید
شما باید یک پروژه Google Cloud راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید
وارد کنسول Play شوید
برای ورود به سیستم، به کنسول Google Play بروید. اگر قبلاً برای کنسول Play ثبت نام نکرده اید، از شما خواسته می شود که این کار را انجام دهید.
بازی خود را به کنسول Play اضافه کنید
برای افزودن بازی خود، این مراحل را دنبال کنید:
در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.
به Grow > Play Games Services > Setup and management > Configuration بروید.
مشخص کنید که آیا بازی شما قبلاً از APIهای Google (مانند Firebase) استفاده میکند یا خیر. مهم است که گزینه صحیح را انتخاب کنید. در غیر این صورت، بازی شما ممکن است هنگام استفاده از Google API با مشکلاتی مواجه شود. در اینجا گزینه ها وجود دارد:
نه، بازی من از Google APIs استفاده نمیکند : اگر بازی جدیدی ایجاد میکنید یا هرگز API Google برای آن تنظیم نکردهاید، این گزینه را انتخاب کنید. نام بازی خود را وارد کنید و سپس روی ایجاد کلیک کنید.
بله، بازی من قبلاً از Google APIs استفاده میکند : اگر قبلاً Google API را برای بازی تنظیم کردهاید، این گزینه را انتخاب کنید. اگر اینطور باشد، لیستی از پروژه های خود را از Google Cloud Console خواهید دید. پروژه خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید.
استفاده از پروژه موجود خدمات بازیهای Play : اگر میخواهید از پروژه سرویسهای بازیهای Play موجود استفاده کنید، این گزینه را انتخاب کنید. فهرستی از پروژههای موجود خدمات بازیهای Play را برای حساب خود خواهید دید. پروژه بازی خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید. این یک انتخاب معمولی نیست، اما اگر در حال ایجاد یک بازی جدید در Play Console به منظور تغییر نام بسته هستید، یا اگر نسخههای رایگان و پولی بازی خود را با نامهای بسته متفاوت دارید، ممکن است این کار را انجام دهید.
یک پروژه بازی خدمات بازیهای Play ایجاد میشود و ورودی مربوطه برای شما در Google Cloud Console ایجاد میشود.
در بخش Properties ، روی Edit Properties کلیک کنید تا اطلاعاتی مانند توضیحات، دسته بندی و دارایی های گرافیکی بازی خود را اضافه کنید. در اینجا چند دستورالعمل برای پیکربندی ویژگی ها آورده شده است:
فقط نام نمایشی برای آزمایش مورد نیاز است. قبل از اینکه بتوانید بازی خود را منتشر کنید، سایر فیلدها باید پر شوند.
نام نمایشی و توضیحات بازی شما باید با آنچه در فهرست فروشگاه Play بازی خود تنظیم کرده اید مطابقت داشته باشد.
برای دستورالعملهای مربوط به ایجاد داراییهای گرافیکی، به افزودن داراییهای پیشنمایش برای نمایش برنامهتان و دستورالعملهای تصویر ویژه Google Play مراجعه کنید.
شناسه مشتری OAuth 2.0 ایجاد کنید
بازی شما باید دارای شناسه مشتری OAuth 2.0 باشد تا بتواند احراز هویت شود و مجاز به تماس با خدمات بازی های Google Play باشد. برای تنظیم اعتبار برای خدمات بازیهای Play، که ارتباط بین شناسه مشتری و بازی شما است، از Google Cloud Platform برای ایجاد شناسه مشتری استفاده کنید. سپس، از کنسول Google Play برای افزودن اعتبار استفاده کنید و شناسه مشتری را به بازی خود پیوند دهید.
برای دستورالعمل های دقیق تر، مراحل زیر را ببینید:
صفحه رضایت OAuth را پیکربندی کنید
اگر هنوز صفحه رضایت OAuth را پیکربندی نکرده اید، بخش اعتبارنامه پیامی را نشان می دهد که از شما می خواهد پیکربندی کنید.
روی پیکربندی کلیک کنید. این یک گفتگو با دستورالعمل های بیشتر و یک پیوند عمیق به Google Cloud Platform باز می کند.
اطمینان حاصل کنید که صفحه رضایت برای همه کسانی که بازی در دسترس هستند در دسترس باشد. فهرست نهایی دامنه ها باید شامل games
، games_lite
و drive.appdata
باشد. هیچ یک از این حوزه ها به تأیید برنامه نیاز ندارند. توصیه می کنیم فوراً صفحه رضایت را منتشر کنید. اگر این امکان وجود ندارد، میتوانید صفحه رضایت را در دسترس آزمایشکنندگان قرار دهید تا به آنها اجازه ورود به بازی را بدهید.
اگر تنظیمات صفحه رضایت OAuth را کامل کرده اید، روی انجام شد کلیک کنید. کنسول Google Play به طور خودکار بازخوانی می شود، و اگر پیکربندی موفقیت آمیز بود، می توانید یک اعتبار ایجاد کنید:
اعتبارنامه ایجاد کنید
برای اینکه بازی خود را برای برقراری ارتباط با خدمات بازیهای Google Play مجاز کنید، باید اعتباری با شناسه مشتری OAuth2 مجاز ایجاد کنید.
در بخش اعتبارنامه ها ، روی افزودن اعتبار کلیک کنید.
در جادوگر، انتخاب کنید که آیا میخواهید یک اعتبارنامه Android ایجاد کنید (اگر APK بازی شما کاربر را احراز هویت میکند و از APIهای خدمات بازیهای Play استفاده میکند) یا اعتبار سرور بازی (اگر سرور بازی شما از APIهای خدمات بازیهای Play استفاده میکند). دستورالعمل های مربوط به نوع اعتبار مورد نظر خود را دنبال کنید.
اندروید
تنظیم جزئیات اعتبار
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد. انتخاب کنید که آیا Anti-Piracy فعال شود یا خیر.
مجوز را تنظیم کنید
سپس، یک شناسه مشتری OAuth را برای استفاده برای این پروژه بازی انتخاب کنید. اگر از قبل شناسه مشتری OAuth2 دارید، می توانید یکی را انتخاب کنید. با این حال، شما معمولا یک مورد جدید ایجاد می کنید. روی ایجاد مشتری OAuth کلیک کنید. این یک گفتگو با پیوندهای عمیق و دستورالعملهای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز میکند.
- اندروید را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت Name وارد کنید.
- نام بسته برنامه اندروید خود را در قسمت Package name وارد کنید.
یک ترمینال را باز کنید و ابزار Keytool را اجرا کنید تا اثر انگشت SHA1 گواهی های انتشار و اشکال زدایی را دریافت کنید.
برای دریافت اثر انگشت گواهی انتشار، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-production-keystore> -v
برای دریافت اثر انگشت گواهی اشکال زدایی، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-debug-keystore> -v
ابزار keytool از شما می خواهد که یک رمز عبور برای keystore وارد کنید. رمز عبور پیش فرض برای دیباگ کیستور
android
است. سپس ابزار کلید اثر انگشت را روی ترمینال چاپ می کند.اثر انگشت SHA1 را در قسمت اثر انگشت گواهی امضا (SHA1) جایگذاری کنید.
روی ایجاد کلیک کنید.
برای اطلاعات بیشتر در مورد OAuth 2.0 در Android، احراز هویت در خدمات OAuth2 را ببینید.
پس از اینکه در کادر گفتگو روی Done کلیک کردید، شناسه های مشتری موجود بازخوانی می شوند. اعتباری را که ایجاد کرده اید از منوی کشویی انتخاب کنید و سپس روی ذخیره تغییرات کلیک کنید. این اعتبارنامه را به عنوان پیشنویس ایجاد میکند و شما را قادر میسازد تا به خدمات بازیهای Play در بازی خود احراز هویت کنید.
ممکن است بخواهید دو اعتبار ایجاد کنید: یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی. مطمئن شوید که از یک نام بسته برای هر دو استفاده می کنید. این به خدمات بازیهای Google Play اجازه میدهد تا تماسها را از APKهای مرتبط شما که با هر یک از گواهیها امضا شدهاند، تشخیص دهد. برای اطلاعات بیشتر درباره امضای گواهی برای Android، به امضای برنامه خود مراجعه کنید.
سرور بازی
تنظیم جزئیات اعتبار
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد.
مجوز را تنظیم کنید
سپس، یک شناسه مشتری OAuth را برای استفاده برای این پروژه بازی انتخاب کنید. اگر از قبل شناسه مشتری OAuth2 دارید، می توانید یکی را انتخاب کنید. با این حال، شما معمولا یک مورد جدید ایجاد می کنید. روی ایجاد مشتری OAuth کلیک کنید. این یک گفتگو با پیوندهای عمیق و دستورالعملهای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز میکند.
- برنامه وب را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت Name وارد کنید.
- روی ایجاد کلیک کنید.
برای اطلاعات بیشتر در مورد OAuth 2.0 در Android، احراز هویت در خدمات OAuth2 را ببینید.
پس از اینکه در کادر گفتگو روی Done کلیک کردید، شناسه های مشتری موجود بازخوانی می شوند. اعتباری را که ایجاد کرده اید از منوی کشویی انتخاب کنید و سپس روی ذخیره تغییرات کلیک کنید. این اعتبارنامه را به عنوان پیشنویس ایجاد میکند و شما را قادر میسازد تا از سرور بازی خود به خدمات بازیهای Play احراز هویت کنید. برای اطلاعات بیشتر در مورد استفاده از خدمات بازی های Play با سرور بازی خود، به فعال کردن دسترسی سمت سرور به خدمات بازی های Google Play مراجعه کنید.
تست را فعال کنید
برای اطمینان از اینکه خدمات بازی های Google Play به درستی در بازی شما کار می کند، باید خدمات بازی خود را قبل از انتشار تغییرات بازی خود در Google Play آزمایش کنید.
اگر بازی شما در حالت منتشر نشده است، با افزودن حساب های کاربری آنها به لیست مجاز، به آزمایش کنندگان خود اجازه دسترسی بدهید. در غیر این صورت، آزمایشکنندگان شما هنگام تلاش برای دسترسی به نقاط پایانی خدمات بازیهای Play، مانند نقطه پایانی ورود به سیستم، با خطاهای OAuth و 404 مواجه خواهند شد.
کاربرانی که دارای حسابهای آزمایشی مجاز هستند به پروژه بازی خدمات بازیهای Play منتشر نشده شما دسترسی خواهند داشت و میتوانند آزمایش کنند که سرویسهای بازیهای Play پیکربندی شده شما به درستی کار میکنند.
دو راه برای فعال کردن آزمایشکنندگان برای استفاده از APIهای خدمات بازیهای Play برای بازی شما وجود دارد:
در سطح فردی، با افزودن آدرس های ایمیل فردی.
در سطح گروه، با فعال کردن خدمات بازیهای Play برای آهنگ انتشار کنسول Play.
برای افزودن تسترهای فردی به پروژه بازی خود:
- برگه آزمایشکنندهها را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازیهای Play > راهاندازی و مدیریت > آزمایشکنندگان ).
- روی دکمه Add testers کلیک کنید.
- در گفتگویی که ظاهر میشود، آدرسهای ایمیل حسابهای Google را که میخواهید به عنوان آزمایشکننده اضافه کنید (با کاما یا یک آدرس ایمیل در هر خط از هم جدا شده) وارد کنید.
- برای ذخیره کاربران به عنوان آزمایش کننده، روی افزودن کلیک کنید. حسابهای آزمایشکنندهای که اضافه کردید باید ظرف چند ساعت به خدمات بازیهای Play دسترسی داشته باشند.
برای دسترسی آزمایشی به یک گروه، یک آهنگ انتشار را برای دسترسی به خدمات بازیهای Play فعال کنید:
Google Play با ویژگیهای آهنگ انتشار، توزیع نسخههای پیشانتشار برنامهتان را بین گروههای کنترلشده از کاربران مورد اعتماد آسان میکند. به تنظیم یک آزمایش باز، بسته یا داخلی در وبسایت راهنمای Google Play مراجعه کنید.
میتوانید به همه کاربرانی که به فایلهای APK آزمایشی در یک آهنگ منتشر شده دسترسی دارند، اجازه دهید برای آزمایش بازی خود دسترسی داشته باشند. این کار به همان صورت عمل می کند که اگر آنها را به صورت جداگانه به لیست آزمایش کننده اضافه کرده باشید. برای این کار مراحل زیر را دنبال کنید:
- بخش PGS Testers ( Grow > Play Games Services > Setup and management > Testers ) را باز کنید و برگه Release tracks را انتخاب کنید. در این صفحه، همچنین میتوانید فهرست آهنگهایی را که قبلاً برای آزمایش خدمات بازیهای Play فعال شدهاند، مشاهده کنید.
- روی افزودن آهنگها کلیک کنید.
- یک یا چند آهنگ را برای فعال کردن آزمایش خدمات بازیهای Play انتخاب کنید.
- روی Add Tracks کلیک کنید.
آهنگهای انتشار انتخابشده اکنون در فهرست آهنگهای فعال برای آزمایش خدمات بازیهای Play ظاهر میشوند.
این ویژگی تنها در صورتی در دسترس است که یک برنامه اندرویدی به بازی خود در کنسول Google Play مرتبط کرده باشید.
از مسائل رایج اجتناب کنید
برای جلوگیری از اشتباهات رایج در راه اندازی، هنگام تنظیم بازی خود برای استفاده از خدمات بازی های Google Play، از این توصیه ها پیروی کنید.
- 1. بازی خود را با کنسول Play تنظیم کنید
- اگر یک شناسه مشتری Oauth 2.0 برای برنامه خود در Google Cloud Console ایجاد کرده باشید، خدمات بازی های Google Play از ارتباط بین دستاوردهای بازی و تابلوهای امتیازات و شناسه مشتری اطلاعی نخواهد داشت. برای ایجاد این ارتباط، باید با استفاده از شناسه مشتری Oauth 2.0 همانطور که در Create a credential توضیح داده شده است، یک اعتبارنامه ایجاد کنید.
- 2. از شناسه برنامه صحیح در اندروید استفاده کنید
- شناسه برنامه یک منبع رشته مورد نیاز است که باید در مانیفست اندروید خود به آن ارجاع دهید. رشته شناسه برنامه فقط از ارقام (معمولاً 12 یا بیشتر) در ابتدای شناسه سرویس گیرنده ارائه شده توسط Play Console تشکیل شده است. شناسه برنامه را می توان در بالای صفحه پیکربندی پیدا کرد و در زیر نام بازی شما به عنوان شناسه پروژه برچسب گذاری شده است.
- 3. APK خود را با گواهی صحیح امضا کنید
- هنگام پیوند برنامه اندروید خود به بازی خود در کنسول Play، باید دقیقاً از همان نام بسته و اثر انگشت گواهی استفاده کنید که برای انتشار برنامه خود استفاده کرده اید. در صورت عدم تطابق، تماسها با خدمات بازیهای Google Play ناموفق خواهند بود. شما باید دو شناسه مشتری ایجاد کنید، یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی، و از یک نام بسته برای هر دو استفاده کنید. برای کسب اطلاعات بیشتر درباره نحوه تعیین گواهی امضا در کنسول Play، به امضای برنامههای شما مراجعه کنید.
- 4. هنگام توسعه برای Android، Play Games SDK را به عنوان یک پروژه کتابخانه، نه به عنوان یک JAR مستقل، قرار دهید.
- مطمئن شوید که Google Play Services SDK به عنوان یک پروژه کتابخانه در پروژه Android شما ارجاع شده باشد، در غیر این صورت زمانی که برنامه شما نتواند منابع خدمات Google Play را پیدا کند، ممکن است منجر به خطا شود. برای آشنایی با نحوه راهاندازی پروژه Android برای استفاده از خدمات Google Play، به راهاندازی خدمات Google Play مراجعه کنید.
- 5. در حین توسعه با یک حساب آزمایشی وارد شوید
- اگر تغییرات تنظیمات بازی خود را در Play Console منتشر نکردهاید، اگر با حساب آزمایشی در لیست سفید وارد نشده باشید، ممکن است در حین آزمایش با خطاهایی مواجه شوید. همیشه باید حساب ناشر Play Console خود را برای آزمایش فعال کنید. برای آشنایی با نحوه مدیریت حسابهای آزمایشکننده، به فعال کردن حسابها برای آزمایش مراجعه کنید.
- 6. صفحه رضایت را در Google Cloud Platform منتشر کنید
- قبل از انتشار برنامه در کنسول Play، صفحه رضایت را در Google Cloud Platform منتشر کنید. بدون این مرحله، مخاطبان عمومی نمیتوانند از هیچ یک از ویژگیهای «خدمات بازیهای Play» استفاده کنند.
- 7. در زمان انتشار، ابتدا تنظیمات Play Games Services را قبل از انتشار بازی خود منتشر کنید
- ممکن است برنامهنویسان بهطور تصادفی برنامه خود را بدون انتشار تنظیمات مربوط به خدمات بازیهای Play برای برنامه خود منتشر کنند. این ممکن است باعث شود بازیکنانی که با حسابهای غیر آزمایشکننده وارد سیستم میشوند با خطا مواجه شوند زیرا برنامه نمیتواند به تنظیمات صحیح بازی اشاره کند. هنگام انتشار بازی، به یاد داشته باشید که ابتدا تنظیمات بازی خود را با استفاده از گزینه Publish Game در کنسول Play منتشر کنید. برای آشنایی با نحوه انتشار تغییرات، به انتشار تغییرات بازی خود مراجعه کنید.
برای راهنماییهای بیشتر، راهنمای عیبیابی Android را ببینید.
مراحل بعدی
پس از تکمیل وظایف راهاندازی اولیه که در بالا توضیح داده شد، میتوانید ویژگیهای «خدمات بازیهای Play» را برای بازی خود فعال کنید ، مانند بازیهای ذخیره شده، تابلوهای امتیازات و دستاوردها.
،در این صفحه نحوه راه اندازی سرویس های بازی های Google Play برای بازی اندروید خود با استفاده از کنسول Google Play توضیح داده شده است. کنسول Play مکانی متمرکز برای مدیریت سرویسهای بازی و پیکربندی فرادادههای مورد استفاده برای تأیید و احراز هویت بازی شما فراهم میکند.
برای افزودن بازی خود به Play Console، این مراحل کلی را دنبال کنید:
یک پروژه بازی برای بازی خود ایجاد کنید و جزئیاتی مانند نام و توضیحات بازی را مشخص کنید.
اعتبارنامههای لازم برای تأیید و تأیید اعتبار بازی خود را به خدمات بازیهای Google Play ایجاد و پیوند دهید.
قبل از شروع
قبل از پیکربندی خدمات بازی های Google Play، مراحل زیر را کامل کنید.
یک حساب توسعه دهنده Google Play ایجاد کنید
شما باید یک حساب برنامهنویس Google Play در Play Console راهاندازی کرده باشید. برای اطلاعات بیشتر، به ثبت نام برای یک حساب برنامهنویس Google Play مراجعه کنید.
اعطای مجوز ویرایش: برای ویرایش تنظیمات خدمات بازیهای Play در کنسول Play، تیم شما باید مجوزهایی برای مدیریت خدمات بازیهای Play داشته باشد. برای اطلاعات بیشتر، به افزودن کاربران حساب برنامهنویس و مدیریت مجوزها مراجعه کنید.
یک پروژه Google Cloud ایجاد کنید
شما باید یک پروژه Google Cloud راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید
وارد کنسول Play شوید
برای ورود به سیستم، به کنسول Google Play بروید. اگر قبلاً برای کنسول Play ثبت نام نکرده اید، از شما خواسته می شود که این کار را انجام دهید.
بازی خود را به کنسول Play اضافه کنید
برای افزودن بازی خود، این مراحل را دنبال کنید:
در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.
به Grow > Play Games Services > Setup and management > Configuration بروید.
مشخص کنید که آیا بازی شما قبلاً از APIهای Google (مانند Firebase) استفاده میکند یا خیر. مهم است که گزینه صحیح را انتخاب کنید. در غیر این صورت، بازی شما ممکن است هنگام استفاده از Google API با مشکلاتی مواجه شود. در اینجا گزینه ها وجود دارد:
نه، بازی من از Google APIs استفاده نمیکند : اگر بازی جدیدی ایجاد میکنید یا هرگز API Google برای آن تنظیم نکردهاید، این گزینه را انتخاب کنید. نام بازی خود را وارد کنید و سپس روی ایجاد کلیک کنید.
بله، بازی من قبلاً از Google APIs استفاده میکند : اگر قبلاً Google API را برای بازی تنظیم کردهاید، این گزینه را انتخاب کنید. اگر اینطور باشد، لیستی از پروژه های خود را از Google Cloud Console خواهید دید. پروژه خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید.
استفاده از پروژه موجود خدمات بازیهای Play : اگر میخواهید از پروژه سرویسهای بازیهای Play موجود استفاده کنید، این گزینه را انتخاب کنید. فهرستی از پروژههای موجود خدمات بازیهای Play را برای حساب خود خواهید دید. پروژه بازی خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید. این یک انتخاب معمولی نیست، اما اگر در حال ایجاد یک بازی جدید در Play Console به منظور تغییر نام بسته هستید، یا اگر نسخههای رایگان و پولی بازی خود را با نامهای بسته متفاوت دارید، ممکن است این کار را انجام دهید.
یک پروژه بازی خدمات بازیهای Play ایجاد میشود و ورودی مربوطه برای شما در Google Cloud Console ایجاد میشود.
در بخش Properties ، روی Edit Properties کلیک کنید تا اطلاعاتی مانند توضیحات، دسته بندی و دارایی های گرافیکی بازی خود را اضافه کنید. در اینجا چند دستورالعمل برای پیکربندی ویژگی ها آورده شده است:
فقط نام نمایشی برای آزمایش مورد نیاز است. قبل از اینکه بتوانید بازی خود را منتشر کنید، سایر فیلدها باید پر شوند.
نام نمایشی و توضیحات بازی شما باید با آنچه در فهرست فروشگاه Play بازی خود تنظیم کرده اید مطابقت داشته باشد.
برای دستورالعملهای مربوط به ایجاد داراییهای گرافیکی، به افزودن داراییهای پیشنمایش برای نمایش برنامهتان و دستورالعملهای تصویر ویژه Google Play مراجعه کنید.
شناسه مشتری OAuth 2.0 ایجاد کنید
بازی شما باید دارای شناسه مشتری OAuth 2.0 باشد تا بتواند احراز هویت شود و مجاز به تماس با خدمات بازی های Google Play باشد. برای تنظیم اعتبار برای خدمات بازیهای Play، که ارتباط بین شناسه مشتری و بازی شما است، از Google Cloud Platform برای ایجاد شناسه مشتری استفاده کنید. سپس، از کنسول Google Play برای افزودن اعتبار استفاده کنید و شناسه مشتری را به بازی خود پیوند دهید.
برای دستورالعمل های دقیق تر، مراحل زیر را ببینید:
صفحه رضایت OAuth را پیکربندی کنید
اگر هنوز صفحه رضایت OAuth را پیکربندی نکرده اید، بخش اعتبارنامه پیامی را نشان می دهد که از شما می خواهد پیکربندی کنید.
روی پیکربندی کلیک کنید. این یک گفتگو با دستورالعمل های بیشتر و یک پیوند عمیق به Google Cloud Platform باز می کند.
اطمینان حاصل کنید که صفحه رضایت برای همه کسانی که بازی در دسترس هستند در دسترس باشد. فهرست نهایی دامنه ها باید شامل games
، games_lite
و drive.appdata
باشد. هیچ یک از این حوزه ها به تأیید برنامه نیاز ندارند. توصیه می کنیم فوراً صفحه رضایت را منتشر کنید. اگر این امکان وجود ندارد، میتوانید صفحه رضایت را در دسترس آزمایشکنندگان قرار دهید تا به آنها اجازه ورود به بازی را بدهید.
اگر تنظیمات صفحه رضایت OAuth را کامل کرده اید، روی انجام شد کلیک کنید. کنسول Google Play به طور خودکار بازخوانی می شود، و اگر پیکربندی موفقیت آمیز بود، می توانید یک اعتبار ایجاد کنید:
اعتبارنامه ایجاد کنید
برای اینکه بازی خود را برای برقراری ارتباط با خدمات بازیهای Google Play مجاز کنید، باید اعتباری با شناسه مشتری OAuth2 مجاز ایجاد کنید.
در بخش اعتبارنامه ها ، روی افزودن اعتبار کلیک کنید.
در جادوگر، انتخاب کنید که آیا میخواهید یک اعتبارنامه Android ایجاد کنید (اگر APK بازی شما کاربر را احراز هویت میکند و از APIهای خدمات بازیهای Play استفاده میکند) یا اعتبار سرور بازی (اگر سرور بازی شما از APIهای خدمات بازیهای Play استفاده میکند). دستورالعمل های مربوط به نوع اعتبار مورد نظر خود را دنبال کنید.
اندروید
تنظیم جزئیات اعتبار
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد. انتخاب کنید که آیا Anti-Piracy فعال شود یا خیر.
مجوز را تنظیم کنید
سپس، یک شناسه مشتری OAuth را برای استفاده برای این پروژه بازی انتخاب کنید. اگر از قبل شناسه مشتری OAuth2 دارید، می توانید یکی را انتخاب کنید. با این حال، شما معمولا یک مورد جدید ایجاد می کنید. روی ایجاد مشتری OAuth کلیک کنید. این یک گفتگو با پیوندهای عمیق و دستورالعملهای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز میکند.
- اندروید را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت Name وارد کنید.
- نام بسته برنامه اندروید خود را در قسمت Package name وارد کنید.
یک ترمینال را باز کنید و ابزار Keytool را اجرا کنید تا اثر انگشت SHA1 گواهی های انتشار و اشکال زدایی را دریافت کنید.
برای دریافت اثر انگشت گواهی انتشار، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-production-keystore> -v
برای دریافت اثر انگشت گواهی اشکال زدایی، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-debug-keystore> -v
ابزار keytool از شما می خواهد که یک رمز عبور برای keystore وارد کنید. رمز عبور پیش فرض برای دیباگ کیستور
android
است. سپس ابزار کلید اثر انگشت را روی ترمینال چاپ می کند.اثر انگشت SHA1 را در قسمت اثر انگشت گواهی امضا (SHA1) جایگذاری کنید.
روی ایجاد کلیک کنید.
برای اطلاعات بیشتر در مورد OAuth 2.0 در Android، احراز هویت در خدمات OAuth2 را ببینید.
پس از اینکه در کادر گفتگو روی Done کلیک کردید، شناسه های مشتری موجود بازخوانی می شوند. اعتباری را که ایجاد کرده اید از منوی کشویی انتخاب کنید و سپس روی ذخیره تغییرات کلیک کنید. این اعتبارنامه را به عنوان پیشنویس ایجاد میکند و شما را قادر میسازد تا به خدمات بازیهای Play در بازی خود احراز هویت کنید.
ممکن است بخواهید دو اعتبار ایجاد کنید: یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی. مطمئن شوید که از یک نام بسته برای هر دو استفاده می کنید. این به خدمات بازیهای Google Play اجازه میدهد تا تماسها را از APKهای مرتبط شما که با هر یک از گواهیها امضا شدهاند، تشخیص دهد. برای اطلاعات بیشتر درباره امضای گواهی برای Android، به امضای برنامه خود مراجعه کنید.
سرور بازی
تنظیم جزئیات اعتبار
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد.
مجوز را تنظیم کنید
سپس، یک شناسه مشتری OAuth را برای استفاده برای این پروژه بازی انتخاب کنید. اگر از قبل شناسه مشتری OAuth2 دارید، می توانید یکی را انتخاب کنید. با این حال، شما معمولا یک مورد جدید ایجاد می کنید. روی ایجاد مشتری OAuth کلیک کنید. این یک گفتگو با پیوندهای عمیق و دستورالعملهای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز میکند.
- برنامه وب را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت Name وارد کنید.
- روی ایجاد کلیک کنید.
برای اطلاعات بیشتر در مورد OAuth 2.0 در Android، احراز هویت در خدمات OAuth2 را ببینید.
پس از اینکه در کادر گفتگو روی Done کلیک کردید، شناسه های مشتری موجود بازخوانی می شوند. اعتباری را که ایجاد کرده اید از منوی کشویی انتخاب کنید و سپس روی ذخیره تغییرات کلیک کنید. این اعتبارنامه را به عنوان پیشنویس ایجاد میکند و شما را قادر میسازد تا از سرور بازی خود به خدمات بازیهای Play احراز هویت کنید. برای اطلاعات بیشتر در مورد استفاده از خدمات بازی های Play با سرور بازی خود، به فعال کردن دسترسی سمت سرور به خدمات بازی های Google Play مراجعه کنید.
تست را فعال کنید
برای اطمینان از اینکه خدمات بازی های Google Play به درستی در بازی شما کار می کند، باید خدمات بازی خود را قبل از انتشار تغییرات بازی خود در Google Play آزمایش کنید.
اگر بازی شما در حالت منتشر نشده است، با افزودن حساب های کاربری آنها به لیست مجاز، به آزمایش کنندگان خود اجازه دسترسی بدهید. در غیر این صورت، آزمایشکنندگان شما هنگام تلاش برای دسترسی به نقاط پایانی خدمات بازیهای Play، مانند نقطه پایانی ورود به سیستم، با خطاهای OAuth و 404 مواجه خواهند شد.
کاربرانی که دارای حسابهای آزمایشی مجاز هستند به پروژه بازی خدمات بازیهای Play منتشر نشده شما دسترسی خواهند داشت و میتوانند آزمایش کنند که سرویسهای بازیهای Play پیکربندی شده شما به درستی کار میکنند.
دو راه برای فعال کردن آزمایشکنندگان برای استفاده از APIهای خدمات بازیهای Play برای بازی شما وجود دارد:
در سطح فردی، با افزودن آدرس های ایمیل فردی.
در سطح گروه، با فعال کردن خدمات بازیهای Play برای آهنگ انتشار کنسول Play.
برای افزودن تسترهای فردی به پروژه بازی خود:
- برگه آزمایشکنندهها را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازیهای Play > راهاندازی و مدیریت > آزمایشکنندگان ).
- روی دکمه Add testers کلیک کنید.
- در گفتگویی که ظاهر میشود، آدرسهای ایمیل حسابهای Google را که میخواهید به عنوان آزمایشکننده اضافه کنید (با کاما یا یک آدرس ایمیل در هر خط از هم جدا شده) وارد کنید.
- برای ذخیره کاربران به عنوان آزمایش کننده، روی افزودن کلیک کنید. حسابهای آزمایشکنندهای که اضافه کردید باید ظرف چند ساعت به خدمات بازیهای Play دسترسی داشته باشند.
برای دسترسی آزمایشی به یک گروه، یک آهنگ انتشار را برای دسترسی به خدمات بازیهای Play فعال کنید:
Google Play با ویژگیهای آهنگ انتشار، توزیع نسخههای پیشانتشار برنامهتان را بین گروههای کنترلشده از کاربران مورد اعتماد آسان میکند. به تنظیم یک آزمایش باز، بسته یا داخلی در وبسایت راهنمای Google Play مراجعه کنید.
میتوانید به همه کاربرانی که به فایلهای APK آزمایشی در یک آهنگ منتشر شده دسترسی دارند، اجازه دهید برای آزمایش بازی خود دسترسی داشته باشند. این کار به همان صورت عمل می کند که اگر آنها را به صورت جداگانه به لیست آزمایش کننده اضافه کرده باشید. برای این کار مراحل زیر را دنبال کنید:
- بخش آزمایشکنندگان PGS ( Grow > Play Games Services > Setup and management > Testers ) را باز کنید و برگه Release tracks را انتخاب کنید. در این صفحه، همچنین میتوانید فهرست آهنگهایی را که قبلاً برای آزمایش خدمات بازیهای Play فعال شدهاند، مشاهده کنید.
- روی افزودن آهنگها کلیک کنید.
- یک یا چند آهنگ را برای فعال کردن آزمایش خدمات بازیهای Play انتخاب کنید.
- روی Add Tracks کلیک کنید.
آهنگهای انتشار انتخابشده اکنون در فهرست آهنگهای فعال برای آزمایش خدمات بازیهای Play ظاهر میشوند.
این ویژگی تنها در صورتی در دسترس است که یک برنامه اندرویدی به بازی خود در کنسول Google Play مرتبط کرده باشید.
از مسائل رایج اجتناب کنید
برای جلوگیری از اشتباهات رایج در راه اندازی، هنگام تنظیم بازی خود برای استفاده از خدمات بازی های Google Play، از این توصیه ها پیروی کنید.
- 1. بازی خود را با کنسول Play تنظیم کنید
- اگر یک شناسه مشتری Oauth 2.0 برای برنامه خود در Google Cloud Console ایجاد کرده باشید، خدمات بازی های Google Play از ارتباط بین دستاوردهای بازی و تابلوهای امتیازات و شناسه مشتری اطلاعی نخواهد داشت. برای ایجاد این ارتباط، باید با استفاده از شناسه مشتری Oauth 2.0 همانطور که در Create a credential توضیح داده شده است، یک اعتبارنامه ایجاد کنید.
- 2. از شناسه برنامه صحیح در اندروید استفاده کنید
- شناسه برنامه یک منبع رشته مورد نیاز است که باید در مانیفست اندروید خود به آن ارجاع دهید. رشته شناسه برنامه فقط از ارقام (معمولاً 12 یا بیشتر) در ابتدای شناسه سرویس گیرنده ارائه شده توسط Play Console تشکیل شده است. شناسه برنامه را می توان در بالای صفحه پیکربندی پیدا کرد و در زیر نام بازی شما به عنوان شناسه پروژه برچسب گذاری شده است.
- 3. APK خود را با گواهی صحیح امضا کنید
- هنگام پیوند برنامه اندروید خود به بازی خود در کنسول Play، باید دقیقاً از همان نام بسته و اثر انگشت گواهی استفاده کنید که برای انتشار برنامه خود استفاده کرده اید. در صورت عدم تطابق، تماسها با خدمات بازیهای Google Play ناموفق خواهند بود. شما باید دو شناسه مشتری ایجاد کنید، یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی، و از یک نام بسته برای هر دو استفاده کنید. برای کسب اطلاعات بیشتر درباره نحوه تعیین گواهی امضا در کنسول Play، به امضای برنامههای شما مراجعه کنید.
- 4. هنگام توسعه برای Android، Play Games SDK را به عنوان یک پروژه کتابخانه، نه به عنوان یک JAR مستقل، قرار دهید.
- مطمئن شوید که Google Play Services SDK به عنوان یک پروژه کتابخانه در پروژه Android شما ارجاع شده باشد، در غیر این صورت زمانی که برنامه شما نتواند منابع خدمات Google Play را پیدا کند، ممکن است منجر به خطا شود. برای آشنایی با نحوه راهاندازی پروژه Android برای استفاده از خدمات Google Play، به راهاندازی خدمات Google Play مراجعه کنید.
- 5. در حین توسعه با یک حساب آزمایشی وارد شوید
- اگر تغییرات تنظیمات بازی خود را در Play Console منتشر نکردهاید، اگر با حساب آزمایشی در لیست سفید وارد نشده باشید، ممکن است در حین آزمایش با خطاهایی مواجه شوید. همیشه باید حساب ناشر Play Console خود را برای آزمایش فعال کنید. برای آشنایی با نحوه مدیریت حسابهای آزمایشکننده، به فعال کردن حسابها برای آزمایش مراجعه کنید.
- 6. صفحه رضایت را در Google Cloud Platform منتشر کنید
- قبل از انتشار برنامه در کنسول Play، صفحه رضایت را در Google Cloud Platform منتشر کنید. بدون این مرحله، مخاطبان عمومی نمیتوانند از هیچ یک از ویژگیهای «خدمات بازیهای Play» استفاده کنند.
- 7. در زمان انتشار، ابتدا تنظیمات Play Games Services را قبل از انتشار بازی خود منتشر کنید
- ممکن است برنامهنویسان بهطور تصادفی برنامه خود را بدون انتشار تنظیمات مربوط به خدمات بازیهای Play برای برنامه خود منتشر کنند. این ممکن است باعث شود بازیکنانی که با حسابهای غیر آزمایشکننده وارد سیستم میشوند با خطا مواجه شوند زیرا برنامه نمیتواند به تنظیمات صحیح بازی اشاره کند. هنگام انتشار بازی، به یاد داشته باشید که ابتدا تنظیمات بازی خود را با استفاده از گزینه Publish Game در کنسول Play منتشر کنید. برای آشنایی با نحوه انتشار تغییرات، به انتشار تغییرات بازی خود مراجعه کنید.
برای راهنماییهای بیشتر، راهنمای عیبیابی Android را ببینید.
مراحل بعدی
پس از تکمیل وظایف راهاندازی اولیه که در بالا توضیح داده شد، میتوانید ویژگیهای «خدمات بازیهای Play» را برای بازی خود فعال کنید ، مانند بازیهای ذخیره شده، تابلوهای امتیازات و دستاوردها.
،در این صفحه نحوه راه اندازی سرویس های بازی های Google Play برای بازی اندروید خود با استفاده از کنسول Google Play توضیح داده شده است. کنسول Play مکانی متمرکز برای مدیریت سرویسهای بازی و پیکربندی فرادادههای مورد استفاده برای تأیید و احراز هویت بازی شما فراهم میکند.
برای افزودن بازی خود به Play Console، این مراحل کلی را دنبال کنید:
یک پروژه بازی برای بازی خود ایجاد کنید و جزئیاتی مانند نام و توضیحات بازی را مشخص کنید.
اعتبارنامههای لازم برای تأیید و تأیید اعتبار بازی خود را به خدمات بازیهای Google Play ایجاد و پیوند دهید.
قبل از شروع
قبل از پیکربندی خدمات بازی های Google Play، مراحل زیر را کامل کنید.
یک حساب توسعه دهنده Google Play ایجاد کنید
شما باید یک حساب برنامهنویس Google Play در Play Console راهاندازی کرده باشید. برای اطلاعات بیشتر، به ثبت نام برای یک حساب برنامهنویس Google Play مراجعه کنید.
اعطای مجوز ویرایش: برای ویرایش تنظیمات خدمات بازیهای Play در کنسول Play، تیم شما باید مجوزهایی برای مدیریت خدمات بازیهای Play داشته باشد. برای اطلاعات بیشتر، به افزودن کاربران حساب برنامهنویس و مدیریت مجوزها مراجعه کنید.
یک پروژه Google Cloud ایجاد کنید
شما باید یک پروژه Google Cloud راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید
وارد کنسول Play شوید
برای ورود به سیستم، به کنسول Google Play بروید. اگر قبلاً برای کنسول Play ثبت نام نکرده اید، از شما خواسته می شود که این کار را انجام دهید.
بازی خود را به کنسول Play اضافه کنید
برای افزودن بازی خود، این مراحل را دنبال کنید:
در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.
به Grow > Play Games Services > Setup and management > Configuration بروید.
مشخص کنید که آیا بازی شما قبلاً از APIهای Google (مانند Firebase) استفاده میکند یا خیر. مهم است که گزینه صحیح را انتخاب کنید. در غیر این صورت، بازی شما ممکن است هنگام استفاده از Google API با مشکلاتی مواجه شود. در اینجا گزینه ها وجود دارد:
نه، بازی من از Google APIs استفاده نمیکند : اگر بازی جدیدی ایجاد میکنید یا هرگز API Google برای آن تنظیم نکردهاید، این گزینه را انتخاب کنید. نام بازی خود را وارد کنید و سپس روی ایجاد کلیک کنید.
بله، بازی من قبلاً از Google APIs استفاده میکند : اگر قبلاً Google API را برای بازی تنظیم کردهاید، این گزینه را انتخاب کنید. اگر اینطور باشد، لیستی از پروژه های خود را از Google Cloud Console خواهید دید. پروژه خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید.
استفاده از پروژه موجود خدمات بازیهای Play : اگر میخواهید از پروژه سرویسهای بازیهای Play موجود استفاده کنید، این گزینه را انتخاب کنید. فهرستی از پروژههای موجود خدمات بازیهای Play را برای حساب خود خواهید دید. پروژه بازی خود را از لیست انتخاب کنید و سپس روی Use کلیک کنید. این یک انتخاب معمولی نیست، اما اگر در حال ایجاد یک بازی جدید در Play Console به منظور تغییر نام بسته هستید، یا اگر نسخههای رایگان و پولی بازی خود را با نامهای بسته متفاوت دارید، ممکن است این کار را انجام دهید.
یک پروژه بازی خدمات بازیهای Play ایجاد میشود و ورودی مربوطه برای شما در Google Cloud Console ایجاد میشود.
در بخش Properties ، برای افزودن اطلاعات ، مانند توضیحات ، دسته و دارایی های گرافیکی برای بازی خود ، روی ویرایش Properties کلیک کنید. در اینجا برخی از دستورالعمل ها برای تنظیم ویژگی ها آورده شده است:
فقط نام نمایشگر برای آزمایش لازم است. قبل از انتشار بازی خود ، زمینه های دیگر باید پر شوند.
نام نمایش و توضیحات برای بازی شما باید مطابق با آنچه در لیست فروشگاه بازی بازی خود تنظیم کرده اید مطابقت داشته باشد.
برای راهنمایی در مورد ایجاد دارایی های گرافیکی ، به اضافه کردن دارایی های پیش نمایش برای نمایش برنامه خود و دستورالعمل های تصویر Google Play مراجعه کنید.
یک شناسه مشتری OAUTH 2.0 ایجاد کنید
بازی شما باید دارای شناسه مشتری OAUTH 2.0 باشد تا تأیید شود و مجاز به تماس با خدمات Google Play Games باشد. برای تنظیم اعتبار برای خدمات بازی های بازی ، که ارتباط بین شناسه مشتری و بازی شما است ، از Google Cloud Platform برای ایجاد شناسه مشتری استفاده کنید. سپس از Google Play Console برای اضافه کردن یک اعتبار استفاده کنید و شناسه مشتری را به بازی خود پیوند دهید.
برای دستورالعمل های دقیق تر ، مراحل زیر را ببینید:
صفحه رضایت OAUTH را پیکربندی کنید
اگر هنوز صفحه رضایت OAuth را پیکربندی نکرده اید ، بخش Credentials پیامی را نشان می دهد که شما را به پیکربندی می اندازد.
روی پیکربندی کلیک کنید. این یک گفتگو با دستورالعمل های بیشتر و پیوند عمیق به پلت فرم Cloud Google را باز می کند.
اطمینان حاصل کنید که صفحه رضایت در دسترس همه است که بازی در دسترس است. لیست نهایی Scopes باید شامل games
، games_lite
و drive.appdata
باشد. هیچ یک از این دامنه ها به تأیید برنامه نیاز ندارند. توصیه می کنیم صفحه رضایت را بلافاصله منتشر کنید. اگر این امکان پذیر نباشد ، می توانید صفحه رضایت را در دسترس آزمایش کنندگان قرار دهید تا به آنها اجازه ورود به بازی را بدهد.
اگر تنظیمات صفحه رضایت OAUTH را به پایان رسانده اید ، روی Done کلیک کنید. Google Play Console به طور خودکار تازه می شود ، و اگر پیکربندی موفقیت آمیز باشد ، می توانید یک اعتبار ایجاد کنید:
یک اعتبار ایجاد کنید
به منظور اجازه دادن به بازی خود برای برقراری ارتباط با خدمات Google Play Games ، باید یک اعتبار با یک شناسه مشتری OAUTH2 مجاز ایجاد کنید.
در بخش Credentials ، روی Add Credential کلیک کنید.
در جادوگر ، انتخاب کنید که آیا می خواهید یک اعتبار Android ایجاد کنید (اگر APK بازی شما کاربر را تأیید کند و از APIS Services Services Services استفاده کند) یا اعتبار سرور بازی (اگر سرور بازی شما از APIS Services Services بازی استفاده می کند). دستورالعمل های خاص با نوع اعتبار مورد نظر خود را دنبال کنید.
اندروید
جزئیات اعتبار را تنظیم کنید
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد. انتخاب کنید که آیا ضد دزدی دریایی را فعال کنید.
مجوز را تنظیم کنید
در مرحله بعد ، یک شناسه مشتری OAUTH را برای استفاده برای این پروژه بازی انتخاب کنید. اگر قبلاً شناسه مشتری OAuth2 دارید ، می توانید یکی را انتخاب کنید. با این حال ، شما معمولاً یک مورد جدید ایجاد خواهید کرد. روی ایجاد مشتری OAUTH کلیک کنید. این گفتگو با پیوندهای عمیق و دستورالعمل ها برای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز می کند.
- Android را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت نام وارد کنید.
- نام بسته برنامه Android خود را در قسمت نام بسته وارد کنید.
یک ترمینال را باز کنید و ابزار KeyTool را اجرا کنید تا اثر انگشت SHA1 گواهینامه های انتشار و اشکال زدایی را بدست آورید.
برای دریافت اثر انگشت گواهی انتشار ، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-production-keystore> -v
برای به دست آوردن اثر انگشت گواهی اشکال زدایی ، دستور زیر را اجرا کنید:
keytool -list -keystore <path-to-debug-keystore> -v
ابزار KeyTool از شما خواسته می شود تا یک رمز عبور را برای کلید اصلی وارد کنید. رمزعبور پیش فرض برای کلید اصلی اشکال زدایی
android
است. Keytool سپس اثر انگشت را به ترمینال چاپ می کند.اثر انگشت SHA1 را در قسمت اثر انگشت گواهی امضا (SHA1) قرار دهید.
روی ایجاد کلیک کنید.
برای کسب اطلاعات بیشتر در مورد OAUTH 2.0 در Android ، به تأیید اعتبار خدمات OAUTH2 مراجعه کنید.
پس از کلیک بر روی Doleog ، شناسه های مشتری موجود تازه می شوند. اعتبار خود را از منوی کشویی انتخاب کرده و سپس روی ذخیره تغییرات کلیک کنید. این اعتبار را به عنوان پیش نویس ایجاد می کند و به شما این امکان را می دهد تا بتوانید خدمات بازی را در بازی خود انجام دهید.
ممکن است بخواهید دو اعتبار ایجاد کنید: یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی. حتماً از همان نام بسته برای هر دو استفاده کنید. این به خدمات Google Play اجازه می دهد تا تماس های APK های مرتبط شما را که با هر یک از گواهینامه ها امضا شده اند ، تشخیص دهند. برای اطلاعات بیشتر در مورد امضای گواهینامه برای Android ، به برنامه خود مراجعه کنید .
سرور بازی
جزئیات اعتبار را تنظیم کنید
اطمینان حاصل کنید که نام در قسمت نام با نام بازی شما مطابقت دارد.
مجوز را تنظیم کنید
در مرحله بعد ، یک شناسه مشتری OAUTH را برای استفاده برای این پروژه بازی انتخاب کنید. اگر قبلاً شناسه مشتری OAuth2 دارید ، می توانید یکی را انتخاب کنید. با این حال ، شما معمولاً یک مورد جدید ایجاد خواهید کرد. روی ایجاد مشتری OAUTH کلیک کنید. این گفتگو با پیوندهای عمیق و دستورالعمل ها برای ایجاد شناسه مشتری OAuth در Google Cloud Platform باز می کند.
- برنامه وب را به عنوان نوع برنامه انتخاب کنید.
- نام بازی خود را در قسمت نام وارد کنید.
- روی ایجاد کلیک کنید.
برای کسب اطلاعات بیشتر در مورد OAUTH 2.0 در Android ، به تأیید اعتبار خدمات OAUTH2 مراجعه کنید.
پس از کلیک بر روی Doleog ، شناسه های مشتری موجود تازه می شوند. اعتبار خود را از منوی کشویی انتخاب کرده و سپس روی ذخیره تغییرات کلیک کنید. این اعتبار را به عنوان پیش نویس ایجاد می کند و به شما این امکان را می دهد تا بتوانید خدمات بازی را از سرور بازی خود بازی کنید. برای کسب اطلاعات بیشتر در مورد استفاده از خدمات بازی های بازی با سرور بازی خود ، به دسترسی به سمت سرور به خدمات Google Play Services مراجعه کنید.
آزمایش را فعال کنید
برای اطمینان از عملکرد صحیح Google Play Services در بازی شما ، باید قبل از انتشار تغییرات بازی خود در Google Play ، خدمات بازی خود را آزمایش کنید.
اگر بازی شما در حالت منتشر نشده قرار دارد ، با افزودن حساب های کاربری خود به لیست اجازه ، به آزمایش کنندگان خود دسترسی پیدا کنید. در غیر این صورت ، آزمایش کنندگان شما هنگام تلاش برای دسترسی به نقاط پایانی خدمات بازی ، مانند نقطه پایان ورود ، با خطای OAuth و 404 روبرو می شوند.
کاربران دارای حساب های تست مجاز به پروژه بازی خدمات بازی های منتشر نشده شما دسترسی خواهند داشت و می توانند آزمایش کنند که خدمات بازی های پیکربندی شده بازی شما به درستی کار می کنند.
دو روش وجود دارد که آزمایش کنندگان را قادر به استفاده از API های خدمات بازی برای بازی شما می کند:
در سطح فردی ، با اضافه کردن آدرس های ایمیل شخصی.
در سطح گروهی ، با فعال کردن خدمات بازی های بازی برای یک آهنگ انتشار کنسول بازی.
برای اضافه کردن آزمایش کنندگان فردی به پروژه بازی خود:
- برگه Testers را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازی های بازی > تنظیم و مدیریت > آزمایش کنندگان ).
- روی دکمه Add Testers کلیک کنید.
- در گفت و گو که ظاهر می شود ، آدرس های ایمیل حساب های Google را که می خواهید به عنوان آزمایش کننده اضافه کنید (جدا شده با کاما یا یک آدرس ایمیل در هر خط) وارد کنید.
- برای ذخیره کاربران به عنوان آزمایش کننده ، روی افزودن کلیک کنید. حسابهای تستر که اضافه کردید باید طی چند ساعت به خدمات بازی های بازی دسترسی پیدا کند.
برای دسترسی به آزمایش به یک گروه ، یک مسیر انتشار را فعال کنید تا به خدمات بازی های بازی دسترسی پیدا کند:
Google Play توزیع نسخه های قبل از انتشار برنامه خود را به گروه های کنترل شده کاربران قابل اعتماد با ویژگی های آهنگ انتشار آسان می کند. مشاهده یک تست باز ، بسته یا داخلی در وب سایت Google Play Help.
شما می توانید دسترسی به بازی خود را به همه کاربرانی که دسترسی به APK های تست در یک مسیر انتشار خاص دارند ، دسترسی پیدا کنید. این همان کار می کند که اگر شما آنها را به صورت جداگانه به لیست تستر اضافه کرده اید. برای این کار مراحل زیر را دنبال کنید:
- بخش PGS Testers را باز کنید ( رشد > خدمات بازی های بازی > تنظیم و مدیریت > آزمایش کنندگان ) و برگه Release Tracks را انتخاب کنید. در این صفحه ، همچنین می توانید لیست آهنگهایی را که قبلاً برای تست خدمات بازی های بازی فعال شده اند ، مشاهده کنید.
- روی افزودن آهنگ ها کلیک کنید.
- برای فعال کردن تست خدمات بازی های بازی ، یک یا چند آهنگ را انتخاب کنید.
- روی افزودن آهنگ ها کلیک کنید.
آهنگ های انتشار انتخاب شده اکنون در لیست آهنگ های فعال شده برای تست خدمات بازی های بازی ظاهر می شوند.
این ویژگی فقط در صورتی در دسترس است که شما یک برنامه Android به بازی خود در Google Play Console مرتبط است.
از مسائل مشترک خودداری کنید
برای جلوگیری از اشتباهات تنظیم مشترک ، حتماً هنگام تنظیم بازی خود برای استفاده از خدمات Google Play Games ، این توصیه ها را دنبال کنید.
- 1. بازی خود را با کنسول بازی تنظیم کنید
- اگر یک شناسه مشتری OAUTH 2.0 را برای برنامه خود در کنسول Google Cloud ایجاد کرده اید ، Google Play Services از ارتباط بین دستیابی به بازی و تابلوهای رهبری و شناسه مشتری اطلاع نخواهد داشت. برای ایجاد این انجمن ، شما باید با استفاده از شناسه مشتری OAUTH 2.0 همانطور که در ایجاد یک اعتبار توضیح داده شده است ، یک اعتبار ایجاد کنید.
- 2. از شناسه برنامه صحیح در Android استفاده کنید
- شناسه برنامه یک منبع رشته مورد نیاز است که باید در مانیفست اندرویدی خود به آن اشاره کنید. رشته شناسه برنامه فقط در ابتدای شناسه مشتری ارائه شده توسط کنسول Play فقط از رقم (به طور معمول 12 یا بیشتر) تشکیل شده است. شناسه برنامه را می توان در بالای صفحه پیکربندی یافت و به عنوان شناسه پروژه زیر نام بازی شما برچسب گذاری شده است.
- 3. APK خود را با گواهی صحیح امضا کنید
- هنگام پیوند برنامه Android خود به بازی خود در کنسول Play ، باید دقیقاً از همان نام بسته و اثر انگشت گواهی استفاده کنید که برای انتشار برنامه خود استفاده کرده اید. اگر عدم تطابق وجود داشته باشد ، تماس با Google Play Services بازی شکست خواهد خورد. شما باید دو شناسه مشتری ایجاد کنید ، یکی با اثر انگشت گواهی انتشار و دیگری با اثر انگشت گواهی اشکال زدایی ، و از همان نام بسته برای هر دو استفاده کنید. برای کسب اطلاعات بیشتر در مورد نحوه مشخص کردن گواهی امضای در کنسول Play ، به امضای برنامه های خود مراجعه کنید.
- 4. هنگام توسعه برای Android ، بازی های SDK بازی های Play را به عنوان یک پروژه کتابخانه قرار دهید ، نه به عنوان یک شیشه مستقل.
- اطمینان حاصل کنید که Google Play Services SDK به عنوان یک پروژه کتابخانه در پروژه Android شما ارجاع شده است ، در غیر این صورت این امر می تواند منجر به خطاها شود که برنامه شما قادر به یافتن منابع خدمات Google Play نباشد. برای یادگیری نحوه تنظیم پروژه Android خود برای استفاده از Google Play Services ، به تنظیم خدمات Google Play مراجعه کنید.
- 5. در حین توسعه با یک حساب کاربری وارد شوید
- اگر در صورت عدم ورود به حساب کاربری وایتلیست شده ، ممکن است در حین آزمایش با خطایی روبرو شوید. شما همیشه باید حساب ناشر کنسول بازی خود را برای آزمایش فعال کنید. برای یادگیری نحوه مدیریت حساب های تستر ، به حساب های فعال سازی آزمایش مراجعه کنید.
- 6. صفحه رضایت را در Google Cloud Platform منتشر کنید
- قبل از انتشار برنامه در کنسول Play ، صفحه رضایت را در Google Cloud Platform منتشر کنید. بدون این مرحله ، مخاطبان عمومی قادر به استفاده از هیچ یک از ویژگی های خدمات بازی های بازی نیستند.
- 7. هنگام انتشار ، قبل از انتشار بازی خود ، ابتدا تنظیمات خدمات بازی های بازی را منتشر کنید
- توسعه دهندگان ممکن است به طور تصادفی برنامه خود را بدون انتشار تنظیمات خدمات بازی های مربوطه برای برنامه خود منتشر کنند. این ممکن است باعث شود بازیکنانی که با حساب های غیر تستر وارد سیستم می شوند با خطاهای روبرو شوند زیرا برنامه نمی تواند تنظیمات صحیح بازی را ارجاع دهد. هنگام انتشار بازی خود ، به یاد داشته باشید که ابتدا تنظیمات بازی خود را با استفاده از گزینه Publish Game در کنسول Play منتشر کنید. برای یادگیری نحوه انتشار تغییرات خود ، به انتشار تغییرات بازی خود مراجعه کنید.
برای راهنمایی های بیشتر ، به راهنمای عیب یابی Android مراجعه کنید.
مراحل بعدی
پس از اتمام وظایف تنظیم اولیه توضیح داده شده در بالا ، می توانید ویژگی های خدمات بازی های بازی را برای بازی خود مانند بازی های ذخیره شده ، تابلوهای رهبری و دستاوردها فعال کنید .