المرجع: اللاعب
مورد "المشغّل"
تمثيل JSON |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة |
playerId |
رقم تعريف المشغّل. |
displayName |
الاسم الذي سيتم عرضه للمشغّل |
avatarImageUrl |
تمثّل هذه السمة عنوان URL الأساسي للصورة التي تمثّل المشغّل. |
bannerUrlPortrait |
عنوان URL لصورة بانر المشغّل في الوضع العمودي |
bannerUrlLandscape |
عنوان URL إلى صورة بانر مشغّل الوضع الأفقي |
originalPlayerId |
رقم تعريف اللاعب الذي تم استخدامه لهذا اللاعب في المرة الأولى التي سجَّل فيها الدخول إلى اللعبة المعنية لا تتم تعبئة هذا الحقل إلّا لاستدعاءات Player.get للاعب الذي أرسل الطلب، وفقط في حال تغيير رقم تعريف المشغّل في وقت لاحق، وفقط للعملاء الذين يتيحون إعادة تخصيص معرّفات اللاعبين. |
profileSettings |
إعدادات الملف الشخصي للّاعب تتحكّم هذه السياسة في ما إذا كان الملف الشخصي للّاعب مرئيًا للّاعبين الآخرين. |
name |
تمثيل كائن للمكوّنات الفردية لاسم اللاعب. قد لا تتوفّر هذه الحقول لدى بعض اللاعبين. |
name.familyName |
اسم عائلة هذا اللاعب وفي بعض الأماكن، يُعرف هذا الاسم باسم العائلة. |
name.givenName |
الاسم المحدّد لهذا اللاعب يُعرف هذا الاسم في بعض الأماكن باسم الاسم الأول. |
experienceInfo |
تمثّل هذه السمة كائنًا لتمثيل معلومات تجربة "لعبة Play" للّاعب. |
title |
هو لقب اللاعب كمكافأة مقابل أنشطته في اللعبة. |
friendStatus |
حالة الصداقة للّاعب المحدّد، بالنسبة إلى مقدِّم الطلب. ولا يتم ضبط هذا الإعداد إذا كان اللاعب لا يشارك قائمة أصدقائه مع اللعبة. |
gamePlayerId |
تشير هذه السمة إلى معرّف فريد لكل تطبيق. |
ProfileSettings
إعدادات الملف الشخصي
تمثيل JSON |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
profileVisible |
ما إذا كان الملف الشخصي للّاعب مرئيًا للمشغّل الذي سجّلت الدخول إليه حاليًا. |
friendsListVisibility |
|
FriendsListVisibility
ما إذا كانت قائمة أصدقاء اللاعب مرئية لهذه اللعبة أو يمكن طلبها لا تتم تعبئة هذا الحقل إلا للمشغّل الذي تسجّل الدخول حاليًا.
عمليات التعداد | |
---|---|
VISIBLE |
قائمة الأصدقاء مرئية للعبة حاليًا. |
REQUEST_REQUIRED |
لا يمكن لمطوِّر البرامج الوصول إلى قائمة الأصدقاء، ولكن يمكنه طلب واجهة برمجة تطبيقات Android لعرض مربّع إفادة الموافقة. |
UNAVAILABLE |
قائمة الأصدقاء غير متاحة حاليًا لهذا المستخدم، ولا يمكن طلب الوصول في الوقت الحالي، إما لأن المستخدم رفض الدعوة نهائيًا أو لأن ميزة الأصدقاء غير متوفرة له. في هذه الحالة، لن تنجح أي محاولات لطلب الوصول إلى قائمة الأصدقاء. |
PlayerExperienceInfo
البيانات الوصفية للطرف الأول/الطرف الثالث حول تجربة المشغّل
تمثيل JSON |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
currentExperiencePoints |
العدد الحالي لنقاط الخبرة للّاعب |
lastLevelUpTimestampMillis |
الطابع الزمني لوقت الارتقاء بمستوى المشغّل، بالمللي ثانية منذ تاريخ Unix للّعبة بالتوقيت العالمي المنسّق |
currentLevel |
المستوى الحالي للّاعب. |
nextLevel |
المستوى التالي من اللاعب. إذا كان المستوى الحالي هو الحد الأقصى، يجب أن يكون هذا المستوى مماثلاً للمستوى الحالي. |
PlayerLevel
بيانات وصفية للطرف الأول أو للطرف الثالث حول مستوى المستخدم
تمثيل JSON |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
level |
مستوى المستخدم. |
minExperiencePoints |
تمثّل هذه السمة الحدّ الأدنى لنقاط الخبرة لهذا المستوى. |
maxExperiencePoints |
تمثّل هذه السمة الحد الأقصى لنقاط الخبرة لهذا المستوى. |
FriendStatus
تحدد علاقات الصداقة بين اللاعبين.
عمليات التعداد | |
---|---|
NO_RELATIONSHIP |
لا توجد علاقة بين اللاعبين. |
FRIEND |
اللاعب ومقدِّم الطلب صديقان. |
الطُرق |
|
---|---|
|
استرداد مورد "المشغّل" باستخدام رقم التعريف المحدّد. |
|
يمكنك الحصول على أرقام تعريف مشغّل التطبيق للّاعب الذي تمت مصادقته حاليًا في جميع الألعاب المطلوبة من قِبل المطوّر نفسه الذي يستخدمه تطبيق الاتصال. |
|
يسترد مُعرّفات المشغّل ضمن النطاق للمستخدم الذي تمت مصادقته حاليًا. |
|
احصل على مجموعة اللاعبين للمستخدم الذي تمت مصادقته حاليًا. |