اگر بازیهای Google Play Games on PC Native شما مستقیماً APIهای Play Billing را فراخوانی میکنند، باید بازی خود را برای استفاده از SDK کامپیوتر منتقل کنید.
بسته به موتور بازی که استفاده میکنید، میتوانید C++ SDK یا C# SDK را ادغام کنید. به پروژههای نمونهای که مثالهایی را نشان میدهند که میتوانند برای انتقال بازی Native شما به SDK استفاده شوند، مراجعه کنید.
راهاندازی و آمادهسازی
این بخش مراحل مهاجرت از یک راهکار مبتنی بر API به SDK بومی بازیهای گوگل پلی روی کامپیوتر را شرح میدهد.
آرگومانهای خط فرمان
SDK بومی بازیهای گوگل پلی روی کامپیوتر برای احراز هویت کاربران به برخی آرگومانهای خط فرمان که در طول راهاندازی فرآیند بازی شما ارسال میشوند، متکی است. این آرگومانها باید به فرآیندی که Initialize SDK را فراخوانی میکند، ارسال شوند. اگر راهاندازی بازی شما شامل چندین فرآیند است، باید تأیید کنید که تمام آرگومانها به فرآیندی که در نهایت از SDK استفاده میکند، ارسال میشوند. مرحله Supporting multi game-processes را در تنظیمات بررسی کنید.
نگاشت API
برای تکمیل مهاجرت، باید تمام فراخوانیهای مستقیم API به سرورهای Play را حذف کنید. فراخوانیهای تابع مربوطه در SDK برای دستیابی به همان عملکرد وجود دارد. این بخش نگاشت هر عملکرد را فهرست میکند.
ورود به سیستم گوگل
ورود به سیستم با گوگل (Google Sign-In) که با نام ورود با گوگل (Login with Google) نیز شناخته میشود، یک روش احراز هویت OAuth است که امکان احراز هویت با یک کلیک را برای کاربرانی که حساب گوگل دارند فراهم میکند. در پروژههای مبتنی بر API، حساب یک بازیکن را با خریدهای او مرتبط میکنید. راهحلهای مبتنی بر SDK نیازی به این ارتباط ندارند.
راهکارهای مبتنی بر SDK از حساب گوگل کلاینت بازیهای گوگل پلی که از قبل با پروفایل و حقوق گیمر بازیکن مرتبط است، استفاده میکنند. این امر تجربهای یکپارچهتر برای بازیکنان و محیطی امنتر برای توسعهدهندگان فراهم میکند، زیرا SDK میتواند از طریق IPC به طور ایمن با کلاینت بازیهای گوگل پلی ارتباط برقرار کند.
به جای Google Sign-In، در اسرع وقت Initialize SDK را فراخوانی کنید. بر اساس کد خطا عمل کنید تا محیطی امن برای زمان اجرای بازی خود فراهم کنید.
دریافت لیست محصولات
در راهکار API، سرور backend شما لیست محصولات را با استفاده از نقطه پایانی inappproduct.gets از Play Developer API بازیابی میکند.
در SDK، لیست محصولات درون برنامهای را مستقیماً در کلاینت با استفاده از تابع QueryProductDetails بازیابی کنید.
خریدها را دریافت کنید
در راهکار API، سرور بکاند شما خریدهای کاربر را با استفاده از نقطه پایانی purchases.products.get در Play Developer API بازیابی میکند.
در SDK، مستقیماً از طریق کلاینت بازی خود از تابع QueryPurchases استفاده کنید.
جریان خرید را راهاندازی کنید
در راهکار API، راهاندازی جریان خرید نیازمند فراخوانی چندین نقطه پایانی برای راهاندازی و دریافت توکنهای لازم است.
در SDK، با فراخوانی تابع LaunchPurchaseFlow از BillingClient ، فرآیند را آغاز کنید. SDK تمام کارهای لازم را انجام میدهد.
خرید را پردازش کنید
پردازش خرید کاربر شامل تأیید و مصرف خرید پس از تأیید موفقیتآمیز قانونی بودن آن است. هم راهکار API و هم راهکار SDK توصیه میکنند که مراحل به دلایل امنیتی از طریق backend شما انجام شود.
این فرآیند برای هر دو راهکار API و SDK مشابه است:
پس از بازیابی purchaseToken از خرید، مانند ProductPurchase.purchaseToken در راهکار API یا purchase_token مربوط به ProductPurchaseDetails در راهکار SDK، آن را برای تأیید به backend خود ارسال کنید.
پس از تأیید، پشتیبان شما میتواند پس از اعطای مجوز، خرید را با اطمینان تأیید یا مصرف کند .
ارسال برای آزمایش
برای ارسال بازی خود برای آزمایش، این مراحل را دنبال کنید.
بسته برای ارسال
بازیهایی که از SDK استفاده میکنند باید در قالب Windows App Bundle بستهبندی شده و از طریق Play Console آپلود شوند. برای بستهبندی بازی خود در Windows App Bundle به مستندات مراجعه کنید:
- انتشار خودمدیریتشده: انتشار نصبکننده
- انتشار مدیریتشدهی بازی: انتشار مدیریتشدهی بازی