أنواع القيم

أنواع القيم غير القابلة للتغيير التي تمثّل بيانات "خدمات الألعاب".

ملخّص

توفر طرق أدوات الوصول في المدراء النتائج كزوج <status, valuetype="">، إما بشكل غير متزامن (عبر معاودة الاتصال) أو بشكل متزامن (في حال وجود موصّل حظر).</status,>

قد تكون كائنات أنواع القيمة إما صالحة (تمثل قيمة صالحة) أو غير صالحة. إذا تم عرض الحالة مع كائن نوع القيمة IsSuccess()، ستكون القيمة المرتبطة صالحة دائمًا، وإذا كانت الحالة IsError()، ستكون القيمة المرتبطة دائمًا غير صالحة. يمكن اختبار الصلاحيّة مباشرةً باستخدام طريقة()dvy على كل كائن من كائنات النوع. يُعدّ استدعاء طرق غير صالحة()) لكائن نوع قيمة غير صالح بمثابة خطأ ويجب تجنّبه.

كائنات نوع القيمة غير قابلة للتغيير، وتعكس عرضًا ثابتًا للبيانات الأساسية في الوقت الذي تم فيه استدعاء الموصّل الذي وفّرها.

العناصر من نوع القيمة قابلة للنقل والنسخ بشكل فعّال

يتم عرض خصائص الكائنات من نوع القيمة المعقّدة أو المكلفة لنسخها حسب المرجع. وتقتصر فترة صلاحية المرجع الذي يتم عرضه على فترة بقاء كائن نوع القيمة.

تتوفّر طرق مساعدة لتحويل كائنات أنواع القيم إلى سلاسل تصحيح أو تصحيح أخطاء ساحات المشاركات. إنّ العروض التي يمكن لشخص عادي قراءتها من خلال هذه الطرق هي مخصّصة لأغراض التسجيل وتصحيح الأخطاء فقط، ويجب عدم اعتبارها ثابتة.

صفوف
gpg::الإنجاز	يشير ذلك المصطلح إلى بنية بيانات واحدة تتيح لك الوصول إلى البيانات المتعلّقة بحالة إنجاز معيّن.
gpg::الحدث	يشير ذلك المصطلح إلى بنية بيانات واحدة تحتوي على بيانات عن حالة حدث معيّن.
gpg::ليدربورد	هيكل بيانات واحد يسمح لك بالوصول إلى بيانات حول حالة ليدربورد معيّن، مثل اسمه وصلاحيته.
gpg::MultiplayerInvitation	يشير ذلك المصطلح إلى بنية بيانات تحتوي على بيانات حول الحالة الحالية لدعوة المستخدمين إلى مباراة تعتمد على تناوب الأدوار.
gpg::MultiplayerParticipant	يشير ذلك المصطلح إلى بنية بيانات تحتوي على بيانات حول أحد المشاركين في مباراة متعددة اللاعبين.
gpg::ParticipantResults	بنية بيانات تحتوي على بيانات حول نتائج "TurnBasedMatch" لكل مشارك
gpg::المشغّل	يشير ذلك المصطلح إلى بنية بيانات تسمح لك بالوصول إلى بيانات حول مشغّل معيّن.
gpg::PlayerLevel	بنية بيانات واحدة تحتوي على بيانات حول مستوى اللاعب.
gpg::PlayerStats	يشير ذلك المصطلح إلى بنية بيانات تسمح لك بالوصول إلى بيانات حول مشغّل معيّن.
gpg::RealTimeRoom	يشير ذلك المصطلح إلى بنية بيانات تتضمّن الحالة الحالية لغرفة اللاعبين المتعدّدين في الوقت الفعلي.
gpg::RealTimeRoomConfig	بنية بيانات تحتوي على البيانات المطلوبة لإنشاء عنصر RealTimeRoom
gpg::التقييم	بنية بيانات واحدة تسمح لك بالوصول إلى البيانات المتعلقة بنتيجة اللاعب.
gpg::ScorePage	هيكل بيانات واحد يسمح لك بالوصول إلى بيانات النتيجة.
gpg::ScorePage::Entry	صف ينشئ إدخالاً في صفحة النتائج.
gpg::ScorePage::ScorePageToken	بنية بيانات من النوع شبه الشفاف الذي يمثّل طلب بحث لصفحة ScorePage (أو فارغًا).
gpg::ScoreSummary	هيكل بيانات واحد يسمح لك بالوصول إلى ملخص معلومات الدرجة.
gpg::SnapshotMetadata	يشير ذلك المصطلح إلى هيكل بيانات واحد يتيح لك الوصول إلى البيانات المتعلّقة بحالة بيانات وصفية خاصة بلقطة شاشة.
gpg::SnapshotMetadataChange	يشير هذا المصطلح إلى بنية بيانات واحدة تسمح لك بالوصول إلى البيانات المتعلّقة بحالة لقطة معيّنة.
gpg::SnapshotMetadataChange::CoverImage	يشير هذا المصطلح إلى بنية بيانات واحدة تسمح لك بالوصول إلى البيانات المتعلّقة بحالة صورة غلاف معيّنة.
gpg::TurnBasedMatch	بنية بيانات تحتوي على بيانات حول حالة TurnBasedMatch الحالية
gpg::TurnBasedMatchConfig	بنية بيانات تحتوي على البيانات اللازمة لإنشاء TurnBasedMatch.