تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج واجهة برمجة التطبيقات PGS Recall في لعبتك

توضّح هذه الصفحة كيفية تنفيذ Recall API في لعبتك. يتناول أولاً تقوم بإعداد خادم وعميل اللعبة لدعم واجهة برمجة التطبيقات، ثم ننتقل إلى كيفية تخزين الرموز المميزة واستردادها.

إعداد خادم اللعبة

يمكنك إعداد خادم لعبتك لإرسال طلبات البيانات من واجهة برمجة التطبيقات Recall إلى خوادم Google.

إعداد مشروعك على "خدمات ألعاب Play"

(إذا لم يسبق لك إكمال هذا الإجراء) اتّبِع التعليمات الواردة في إعداد Google Play. "خدمات الألعاب":

إعداد حساب خدمة للعبة

اتبع التعليمات الخاصة بإنشاء خدمة الحساب. في النهاية، من المفترض أن يكون لديك ملف JSON به بيانات اعتماد حساب الخدمة.

تنزيل مكتبة Java من جهة الخادم لتطبيق "خدمات ألعاب Play"

تنزيل أحدث إصدار من google-api-services-games المكتبة وقم بتحميله إلى خادمك.

إعداد بيانات الاعتماد الخاصة باستدعاءات واجهة برمجة التطبيقات Recall

راجِع المقالة الاستعداد لإنشاء واجهة برمجة تطبيقات مفوَّضة. مكالمة للحصول على مزيد من السياق.

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.services.games.Games;
import com.google.api.services.games.GamesScopes;

// ...

GoogleCredential credential =
  GoogleCredential.fromStream(new FileInputStream("<credentials>.json"))
    .createScoped(Collections.singleton(GamesScopes.ANDROIDPUBLISHER));

Games gamesApi =
    new Games.Builder(httpTransport, JSON_FACTORY, credential).build();

إعداد برنامج اللعبة

عليك إعداد برنامج اللعبة لاسترداد معرّفات جلسات الاستدعاء التي يستخدمها الخادم. على الاتصال بخوادم Google.

حزمة تطوير البرامج (SDK) بلغة Java

عليك إعداد حزمة تطوير البرامج (SDK) بلغة Java في البرنامج. وتأكد من تضمين com.google.android.gms:play-services-games-v2:19.0.0 و com.google.android.gms:play-services-tasks:18.0.2 أو أعلى في Gradle الملف.

للاتصال بخوادم Google بالمعلومات الصحيحة، يمكنك طلب يمكنك استرجاع معرِّف الجلسة من حزمة تطوير البرامج (SDK) للعميل، والذي ترسله إلى خادم لعبتك:

Kotlin

PlayGames.getRecallClient(getActivity())
  .requestRecallAccess()
  .addOnSuccessListener { recallAccess -> val recallSessionId: String = recallAccess.getSessionId() }
  // Send the recallSessionId to your game server

Java

PlayGames.getRecallClient(getActivity())
  .requestRecallAccess()
  .addOnSuccessListener(
    recallAccess -> {
      String recallSessionId = recallAccess.getSessionId();
      // Send the recallSessionId to your game server
  });

استخدام Recall API في خادم لعبتك

وبعد إعداد الخادم والعميل، يمكنك إرسال recallSessionID من عميل اللعبة إلى خادم اللعبة، واتبع الإرشادات أدناه لبدء باستخدام واجهة برمجة تطبيقات Java لتخزين الرموز المميزة لاستدعاء الرموز من جانب الخادم أو استردادها أو حذفها.

الرموز المميّزة للمتجر

تخزين شخصية المستخدم والرمز المميز للّعبة باستخدام كائن LinkPersonaRequest استخدام GoogleCredential من أجل الاتصال بـ Google من واجهات برمجة التطبيقات. اتّباع عدد القيم الفريدة للسمة 1:1 قيد، يمكنك ربط شخصية واحدة فقط بملف شخصي واحد على "خدمات ألعاب Play" في كل مرة، والعكس صحيح ضبط سياسة حل في حال سبق أن تم ربط هذا الملف الشخصي على "خدمات ألعاب Play" بملف آخر الشخصية.

يمكنك اختياريًا ضبط مدة بقاء (TTL) على الرمز المميّز مع توضيح مدة فإن الرمز صالح باستخدام Durations الخاص بك. ويمكنك اختيار تعيين هذا باستخدام SetTtl() (كما هو موضح أدناه)، التي تحدد تاريخ انتهاء الصلاحية من مقدار الوقت المحدد في الطريقة setExpireTime()، ما يتيح لك تحديد وقت دقيق لانتهاء صلاحية الرموز المميّزة

يجب تشفير الشخصية والرمز المميّز للّعبة، ولا يمكن تضمينهما في البيانات الشخصية. معلومات التعريف الشخصية. يمكن أن تكون سلاسل الشخصية والرمز المميز 256 كحد أقصى ويمكن أن يكون هناك 20 رمزًا أو شخصية مخزنة على الأكثر لاعب في كل مباراة.

يمكن تخزين رمز مميّز واحد فقط لكل شخصية لكل لاعب في وقت محدَّد. إذا حاولت لتخزين رمز مميز آخر بالشخصية نفسها، يستبدل النظام الرمز الأصلي الرمز المميز.

import com.google.api.services.games.Games.Recall.LinkPersona;
import com.google.protobuf.util.Durations;

// ...

Games gamesApi =
    new Games.Builder(httpTransport, JSON_FACTORY, credential).build();

String recallSessionId = ... // recallSessionID from game client
String persona = ... // encrypted opaque string, stable for in-game account
String token = ... // encrypted opaque string encoding the progress line

LinkPersonaRequest linkPersonaRequest =
  LinkPersonaRequest.newBuilder()
    .setSessionId(recallSessionId)
    .setPersona(persona)
    .setToken(token)
    .setCardinalityConstraint(ONE_PERSONA_TO_ONE_PLAYER)
    .setConflictingLinksResolutionPolicy(CREATE_NEW_LINK)
    .setTtl(Durations.fromDays(7)) // Optionally set TTL for token
    .build();

LinkPersonaResponse linkPersonaResponse =
  gamesApi.recall().linkPersona(linkPersonaRequest).execute();

if (linkPersonaResponse.getState() == LINK_CREATED) {
  // success
}

استرداد الرموز المميّزة

لاسترداد الرمز المميّز للتذكُّر، يجب الحصول على recallSessionId من العميل تمريره إلى واجهة برمجة التطبيقات retrieveTokens:

import com.google.api.services.games.Games.Recall.RetrieveTokens;

// ...

String recallSessionId = ... // recallSessionID from game client

RetrievePlayerTokensResponse retrievePlayerTokensResponse =
  gamesApi.recall().retrieveTokens(recallSessionId).execute();

for (RecallToken recallToken : retrievePlayerTokensResponse.getTokens()) {
  String token recallToken.getToken();
  // Same string as was written in LinkPersona call
  // decrypt and recover in-game account
}

حذف الرمز المميّز لتذكُّر بيانات الألعاب

وإذا لزم الأمر، يمكنك أيضًا حذف الرمز المميّز لتذكُّر بيانات الألعاب من خلال إجراء المكالمة التالية:

import com.google.api.services.games.Games.Recall.UnlinkPersona;

// ...

String recallSessionId = ...
String persona = ...
String token = ...

Games gamesApi =
    new Games.Builder(httpTransport, JSON_FACTORY, credential).build();

UnlinkPersonaRequest unlinkPersonaRequest =
  UnlinkPersonaRequest.newBuilder()
    .setSessionId(recallSessionId)
    .setPersona(persona)
    // .setToken(token) - alternatively set token, but not both
    .build();

UnlinkPersonaResponse unlinkPersonaResponse =
  gamesApi.recall().unlinkPersona(unlinkPersonaRequest).execute();

// Confirm that the unlinking process completed successfully.
boolean unlinked = unlinkPersonaResponse.isUnlinked();

تفعيل وضع "بدون ملف شخصي"

يمكنك تفعيل وظائف Recall API محدودة. للمستخدمين الذين ليس لديهم ملفات شخصية على "خدمات ألعاب Play" باتّباع الخطوات التالية:

تفعيل ميزة التذكُّر بدون ملف شخصي لمشروع لعبتك على "خدمات ألعاب Play" في مطوّر برامج Play وحدة التحكم.
راجِع البنود الإضافية الموضّحة لاحقًا في هذا القسم.
إضافة علامة البيانات الوصفية التالية إلى تطبيقك البيان:

<meta-data
  android:name="com.google.android.gms.games.PROFILELESS_RECALL_ENABLED"
  android:value="true" />

البنود الإضافية

بالإضافة إلى الخضوع لبنود "خدمات ألعاب Play" الخدمة، أنت توافق على أنّه في حال استخدام Recall API مستخدم ليس لديه ملف شخصي على "خدمات ألعاب Play"، ما يتيح مشاركة بيانات المستخدم النهائي لدى Google بدون أن يكون لديه ملف شخصي على "خدمات ألعاب Play"، قبل مشاركة هذه البيانات مع Google، عليك تزويد المستخدم إشعار مناسب يصف 1) مشاركتك للبيانات مع Google لتمكين ألعاب Play ميزة ربط الحساب، 2) توافر الإعدادات المراد إدارتها مثل تلك التي تتم مشاركتها ضمن إعدادات "ألعاب Play" 3) معالجة هذه البيانات بموجب سياسة خصوصية Google السياسة والحصول على مستخدم نهائي مناسب الموافقة على هذه المشاركة التي تستوفي جميع المتطلبات القانونية السارية.