سرویس‌های بازی‌های Google 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 راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید

• با Google Cloud شروع کنید
• ایجاد یک پروژه

وارد کنسول Play شوید

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

بازی خود را به کنسول Play اضافه کنید

برای افزودن بازی خود، این مراحل را دنبال کنید:

1. در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.

2. به Grow > Play Games Services > Setup and management > Configuration بروید.

3. مشخص کنید که آیا بازی شما قبلاً از 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 ایجاد می‌شود.

4. در بخش 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 استفاده می‌کند). دستورالعمل های مربوط به نوع اعتبار مورد نظر خود را دنبال کنید.

تست را فعال کنید

برای اطمینان از اینکه خدمات بازی های Google Play به درستی در بازی شما کار می کند، باید خدمات بازی خود را قبل از انتشار تغییرات بازی خود در Google Play آزمایش کنید.

اگر بازی شما در حالت منتشر نشده است، با افزودن حساب های کاربری آنها به لیست مجاز، به آزمایش کنندگان خود اجازه دسترسی بدهید. در غیر این صورت، آزمایش‌کنندگان شما هنگام تلاش برای دسترسی به نقاط پایانی خدمات بازی‌های Play، مانند نقطه پایانی ورود به سیستم، با خطاهای OAuth و 404 مواجه خواهند شد.

کاربرانی که دارای حساب‌های آزمایشی مجاز هستند به پروژه بازی خدمات بازی‌های Play منتشر نشده شما دسترسی خواهند داشت و می‌توانند آزمایش کنند که سرویس‌های بازی‌های Play پیکربندی شده شما به درستی کار می‌کنند.

دو راه برای فعال کردن آزمایش‌کنندگان برای استفاده از APIهای خدمات بازی‌های Play برای بازی شما وجود دارد:

• در سطح فردی، با افزودن آدرس های ایمیل فردی.

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

برای افزودن تسترهای فردی به پروژه بازی خود:

1. برگه آزمایش‌کننده‌ها را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازی‌های Play > راه‌اندازی و مدیریت > آزمایش‌کنندگان ).
2. روی دکمه Add testers کلیک کنید.
3. در گفتگویی که ظاهر می‌شود، آدرس‌های ایمیل حساب‌های Google را که می‌خواهید به عنوان آزمایش‌کننده اضافه کنید (با کاما یا یک آدرس ایمیل در هر خط از هم جدا شده) وارد کنید.
4. برای ذخیره کاربران به عنوان آزمایش کننده، روی افزودن کلیک کنید. حساب‌های آزمایش‌کننده‌ای که اضافه کردید باید ظرف چند ساعت به خدمات بازی‌های Play دسترسی داشته باشند.

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

Google Play با ویژگی‌های آهنگ انتشار، توزیع نسخه‌های پیش‌انتشار برنامه‌تان را بین گروه‌های کنترل‌شده از کاربران مورد اعتماد آسان می‌کند. به تنظیم یک آزمایش باز، بسته یا داخلی در وب‌سایت راهنمای Google Play مراجعه کنید.

می‌توانید به همه کاربرانی که به فایل‌های APK آزمایشی در یک آهنگ منتشر شده دسترسی دارند، اجازه دهید برای آزمایش بازی خود دسترسی داشته باشند. این کار به همان صورت عمل می کند که اگر آنها را به صورت جداگانه به لیست آزمایش کننده اضافه کرده باشید. برای این کار مراحل زیر را دنبال کنید:

1. بخش PGS Testers ( Grow > Play Games Services > Setup and management > Testers ) را باز کنید و برگه Release tracks را انتخاب کنید. در این صفحه، همچنین می‌توانید فهرست آهنگ‌هایی را که قبلاً برای آزمایش خدمات بازی‌های Play فعال شده‌اند، مشاهده کنید.
2. روی افزودن آهنگ‌ها کلیک کنید.
3. یک یا چند آهنگ را برای فعال کردن آزمایش خدمات بازی‌های Play انتخاب کنید.
4. روی 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 راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید

• با Google Cloud شروع کنید
• ایجاد یک پروژه

وارد کنسول Play شوید

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

بازی خود را به کنسول Play اضافه کنید

برای افزودن بازی خود، این مراحل را دنبال کنید:

1. در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.

2. به Grow > Play Games Services > Setup and management > Configuration بروید.

3. مشخص کنید که آیا بازی شما قبلاً از 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 ایجاد می‌شود.

4. در بخش 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 استفاده می‌کند). دستورالعمل های مربوط به نوع اعتبار مورد نظر خود را دنبال کنید.

تست را فعال کنید

برای اطمینان از اینکه خدمات بازی های Google Play به درستی در بازی شما کار می کند، باید خدمات بازی خود را قبل از انتشار تغییرات بازی خود در Google Play آزمایش کنید.

اگر بازی شما در حالت منتشر نشده است، با افزودن حساب های کاربری آنها به لیست مجاز، به آزمایش کنندگان خود اجازه دسترسی بدهید. در غیر این صورت، آزمایش‌کنندگان شما هنگام تلاش برای دسترسی به نقاط پایانی خدمات بازی‌های Play، مانند نقطه پایانی ورود به سیستم، با خطاهای OAuth و 404 مواجه خواهند شد.

کاربرانی که دارای حساب‌های آزمایشی مجاز هستند به پروژه بازی خدمات بازی‌های Play منتشر نشده شما دسترسی خواهند داشت و می‌توانند آزمایش کنند که سرویس‌های بازی‌های Play پیکربندی شده شما به درستی کار می‌کنند.

دو راه برای فعال کردن آزمایش‌کنندگان برای استفاده از APIهای خدمات بازی‌های Play برای بازی شما وجود دارد:

• در سطح فردی، با افزودن آدرس های ایمیل فردی.

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

برای افزودن تسترهای فردی به پروژه بازی خود:

1. برگه آزمایش‌کننده‌ها را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازی‌های Play > راه‌اندازی و مدیریت > آزمایش‌کنندگان ).
2. روی دکمه Add testers کلیک کنید.
3. در گفتگویی که ظاهر می‌شود، آدرس‌های ایمیل حساب‌های Google را که می‌خواهید به عنوان آزمایش‌کننده اضافه کنید (با کاما یا یک آدرس ایمیل در هر خط از هم جدا شده) وارد کنید.
4. برای ذخیره کاربران به عنوان آزمایش کننده، روی افزودن کلیک کنید. حساب‌های آزمایش‌کننده‌ای که اضافه کردید باید ظرف چند ساعت به خدمات بازی‌های Play دسترسی داشته باشند.

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

Google Play با ویژگی‌های آهنگ انتشار، توزیع نسخه‌های پیش‌انتشار برنامه‌تان را بین گروه‌های کنترل‌شده از کاربران مورد اعتماد آسان می‌کند. به تنظیم یک آزمایش باز، بسته یا داخلی در وب‌سایت راهنمای Google Play مراجعه کنید.

می‌توانید به همه کاربرانی که به فایل‌های APK آزمایشی در یک آهنگ منتشر شده دسترسی دارند، اجازه دهید برای آزمایش بازی خود دسترسی داشته باشند. این کار به همان صورت عمل می کند که اگر آنها را به صورت جداگانه به لیست آزمایش کننده اضافه کرده باشید. برای این کار مراحل زیر را دنبال کنید:

1. بخش آزمایش‌کنندگان PGS ( Grow > Play Games Services > Setup and management > Testers ) را باز کنید و برگه Release tracks را انتخاب کنید. در این صفحه، همچنین می‌توانید فهرست آهنگ‌هایی را که قبلاً برای آزمایش خدمات بازی‌های Play فعال شده‌اند، مشاهده کنید.
2. روی افزودن آهنگ‌ها کلیک کنید.
3. یک یا چند آهنگ را برای فعال کردن آزمایش خدمات بازی‌های Play انتخاب کنید.
4. روی 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 راه اندازی کرده باشید. برای اطلاعات بیشتر، نگاه کنید

• با Google Cloud شروع کنید
• ایجاد یک پروژه

وارد کنسول Play شوید

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

بازی خود را به کنسول Play اضافه کنید

برای افزودن بازی خود، این مراحل را دنبال کنید:

1. در کنسول Play، یک برنامه ایجاد کنید و مشخص کنید که یک بازی است. برای اطلاعات بیشتر، به ایجاد و تنظیم برنامه خود مراجعه کنید.

2. به Grow > Play Games Services > Setup and management > Configuration بروید.

3. مشخص کنید که آیا بازی شما قبلاً از 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 ایجاد می‌شود.

4. در بخش 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 بازی استفاده می کند). دستورالعمل های خاص با نوع اعتبار مورد نظر خود را دنبال کنید.

آزمایش را فعال کنید

برای اطمینان از عملکرد صحیح Google Play Services در بازی شما ، باید قبل از انتشار تغییرات بازی خود در Google Play ، خدمات بازی خود را آزمایش کنید.

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

کاربران دارای حساب های تست مجاز به پروژه بازی خدمات بازی های منتشر نشده شما دسترسی خواهند داشت و می توانند آزمایش کنند که خدمات بازی های پیکربندی شده بازی شما به درستی کار می کنند.

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

• در سطح فردی ، با اضافه کردن آدرس های ایمیل شخصی.

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

برای اضافه کردن آزمایش کنندگان فردی به پروژه بازی خود:

1. برگه Testers را برای بازی خود در کنسول Google Play باز کنید ( رشد > خدمات بازی های بازی > تنظیم و مدیریت > آزمایش کنندگان ).
2. روی دکمه Add Testers کلیک کنید.
3. در گفت و گو که ظاهر می شود ، آدرس های ایمیل حساب های Google را که می خواهید به عنوان آزمایش کننده اضافه کنید (جدا شده با کاما یا یک آدرس ایمیل در هر خط) وارد کنید.
4. برای ذخیره کاربران به عنوان آزمایش کننده ، روی افزودن کلیک کنید. حسابهای تستر که اضافه کردید باید طی چند ساعت به خدمات بازی های بازی دسترسی پیدا کند.

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

Google Play توزیع نسخه های قبل از انتشار برنامه خود را به گروه های کنترل شده کاربران قابل اعتماد با ویژگی های آهنگ انتشار آسان می کند. مشاهده یک تست باز ، بسته یا داخلی در وب سایت Google Play Help.

شما می توانید دسترسی به بازی خود را به همه کاربرانی که دسترسی به APK های تست در یک مسیر انتشار خاص دارند ، دسترسی پیدا کنید. این همان کار می کند که اگر شما آنها را به صورت جداگانه به لیست تستر اضافه کرده اید. برای این کار مراحل زیر را دنبال کنید:

1. بخش PGS Testers را باز کنید ( رشد > خدمات بازی های بازی > تنظیم و مدیریت > آزمایش کنندگان ) و برگه Release Tracks را انتخاب کنید. در این صفحه ، همچنین می توانید لیست آهنگهایی را که قبلاً برای تست خدمات بازی های بازی فعال شده اند ، مشاهده کنید.
2. روی افزودن آهنگ ها کلیک کنید.
3. برای فعال کردن تست خدمات بازی های بازی ، یک یا چند آهنگ را انتخاب کنید.
4. روی افزودن آهنگ ها کلیک کنید.

آهنگ های انتشار انتخاب شده اکنون در لیست آهنگ های فعال شده برای تست خدمات بازی های بازی ظاهر می شوند.

این ویژگی فقط در صورتی در دسترس است که شما یک برنامه 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 مراجعه کنید.

مراحل بعدی

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