تحمي واجهة برمجة التطبيقات Play Integrity API لعبتك من عمليات التفاعل الخطيرة والاحتيالية باستخدام رمز مميز لبيان السلامة يمكنك التحقّق منه على خادم الخلفية.
مساحة الاسم: PlayPcSdkManaged.Integrity
فئة العميل: IntegrityClient
إنشاء العميل
استخدِم المصنع لإنشاء IntegrityClient. تسجّل الدالة البرمجية callbacks الخاصة بـ Unity وتتخلص من العميل عند إيقاف النص البرمجي.
using UnityEngine; using System; using System.Threading.Tasks; // Required SDK Namespaces using PlayPcSdkManaged.Integrity; using PlayPcSdkManaged.Unity; public class IntegrityManager : MonoBehaviour { private IntegrityClient _integrityClient; public void SetupIntegrity() { try { // Creates the client with the required UnityIntegrityCallbacksHandler _integrityClient = PlayPcSdkFactory.CreateIntegrityClient(); Debug.Log("Integrity Client created successfully."); } catch (Exception ex) { Debug.LogError($"Failed to create Integrity Client: {ex.Message}"); } } private void OnDestroy() { // Always dispose of the client _integrityClient?.Dispose(); } }
طلب رمز مميّز للتحقّق من السلامة
يتطلّب طلب رمز مميّز للسلامة خطوتَين:
التحضير: يُعدّ خدمة التحقّق من السلامة وينشئ معرّف جلسة.
الطلب: يستخدم معرّف الجلسة من خطوة الإعداد لطلب الرمز المميّز الموقَّع الفعلي.
public async Task RequestIntegrityTokenAsync() { try { // Replace with your actual Google Cloud Project Number long myCloudProjectNumber = 123456789; // --------------------------------------------------------- // Step 1: Prepare the Token // --------------------------------------------------------- var prepareParams = new PrepareIntegrityTokenParams { CloudProjectNumber = myCloudProjectNumber }; Debug.Log("Preparing Integrity Token..."); var prepareResult = await _integrityClient.PrepareIntegrityTokenAsync(prepareParams); if (!prepareResult.IsOk) { Debug.LogError($"Prepare Failed: {prepareResult.Code} - {prepareResult.ErrorMessage}"); return; } // --------------------------------------------------------- // Step 2: Request the Token // --------------------------------------------------------- // You must use the RequestTokenData returned from the prepare step var requestParams = new RequestIntegrityTokenParams { RequestTokenData = prepareResult.Value.RequestTokenData, // A nonce to bind this token to a specific request or action. // This should be generated by your backend server. RequestHash = "your_secure_nonce_string" }; Debug.Log("Requesting Integrity Token..."); var tokenResult = await _integrityClient.RequestIntegrityTokenAsync(requestParams); if (tokenResult.IsOk) { // The TokenBytes is already a string (Base64 URL-safe web token) string signedToken = tokenResult.Value.TokenBytes; Debug.Log("Integrity Token Received. Sending to backend for verification..."); // Send 'signedToken' to your backend server for verification } else { Debug.LogError($"Request Failed: {tokenResult.Code} - {tokenResult.ErrorMessage}"); } } catch (Exception ex) { Debug.LogException(ex); } }