gpg::TurnBasedMatch

#include <turn_based_match.h>

يشير ذلك المصطلح إلى بنية بيانات تحتوي على بيانات عن حالة TurnBasedMatch.

ملخّص

الشركات المصنّعة والمُصنّعة
TurnBasedMatch()
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
تنشئ TurnBasedMatch من shared_ptr إلى TurnBasedMatchImpl.
TurnBasedMatch(const TurnBasedMatch & copy_from)
تنشئ نسخة من TurnBasedMatch حالية.
TurnBasedMatch(TurnBasedMatch && move_from)
يؤدي هذا الإجراء إلى نقل عنصر TurnBasedMatch حالي.

وظائف عامة
AutomatchingSlotsAvailable() const
uint32_t
عرض عدد خانات المطابقة التلقائية المتاحة للمطابقة.
CreatingParticipant() const
عرض المشارِك الذي أنشأ هذه المطابقة
CreationTime() const
std::chrono::milliseconds
عرض الوقت الذي يتم فيه التعبير عن TurnBasedMatch was created بالمللي ثانية منذ حقبة يونكس).
Data() const
const std::vector< uint8_t > &
عرض بيانات المطابقة إذا كانت HasData() صحيحة.
Description() const
const std::string &
تعرض ملخّصًا أنشأه الخادم لحالة المطابقة
HasData() const
bool
صحيح إذا كان هذا الكائن يحتوي على بيانات تم تعيينها أثناء منعطف سابق.
HasPreviousMatchData() const
bool
صحيح إذا كان هذا هو الدور الأول لإعادة المطابقة، ويجب أن تعرض البيانات من القيمة Valid السابقة القيمة "true" لكي تكون هذه الدالة قابلة للاستخدام.
HasRematchId() const
bool
تعرض القيمة "صحيح" إذا تم مطابقة هذه المطابقة.
Id() const
const std::string &
تعرض معرّفًا يعرّف TurnBasedMatch هذا بشكل فريد.
LastUpdateTime() const
عرض الوقت الذي تم فيه آخر تعديل على TurnBasedMatch (يتم التعبير عنه بالمللي ثانية منذ حقبة Unix).
LastUpdatingParticipant() const
عرض المشارك الذي عدَّل هذه المطابقة مؤخرًا.
Number() const
uint32_t
رقم يشير إلى عدد التطابقات التي سبقت هذا الرقم عن طريق إعادة المطابقة.
ParticipantResults() const
يعرض نتائج المطابقة.
Participants() const
const std::vector< MultiplayerParticipant > &
خط متّجه لجميع المشاركين في هذه المباراة.
PendingParticipant() const
عرض المشارك الذي دوره لتحديث هذه المطابقة.
PreviousMatchData() const
const std::vector< uint8_t > &
البيانات من المطابقة السابقة، إذا كانت HasPreviousMatchData()
RematchId() const
const std::string &
عرض الرقم التعريفي للمطابقة الذي يمثل إعادة مطابقة لهذه المطابقة، إن توفرت.
Status() const
يعرض حالة المطابقة للمشارك المحلي.
SuggestedNextParticipant() const
دالة مساعد تختار مشاركًا صالحًا من مجموعة المشاركين المنضمين واللازمين والمتطابقين تلقائيًا.
Valid() const
bool
تعرض القيمة true إذا تمت تعبئة TurnBasedMatch بالبيانات.
Variant() const
uint32_t
تعرض هذه الميزة معرّف نسخة خاصة باللعبة يمكن أن تستخدمه لعبة لتحديد أوضاع اللعبة المختلفة.
Version() const
uint32_t
رقم تعريف متزايد بشكل صارم، ويتم تعديله في كل مرة يتم فيها تعديل المطابقة.
operator=(const TurnBasedMatch & copy_from)
يمكنك تعيين TurnBasedMatch هذا عن طريق النسخ من ملف آخر.
operator=(TurnBasedMatch && move_from)
تعيِّن TurnBasedMatch هذه من خلال نقل عنصر آخر إليها.

وظائف عامة

AutomatchingSlotsAvailable

uint32_t AutomatchingSlotsAvailable() const

عرض عدد خانات المطابقة التلقائية المتاحة للمطابقة.

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

CreatingParticipant

MultiplayerParticipant CreatingParticipant() const

عرض المشارِك الذي أنشأ هذه المطابقة

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

CreationTime

std::chrono::milliseconds CreationTime() const

عرض الوقت الذي يتم فيه التعبير عن TurnBasedMatch was created بالمللي ثانية منذ حقبة يونكس).

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

البيانات

const std::vector< uint8_t > & Data() const

عرض بيانات المطابقة إذا كانت HasData() صحيحة.

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

الوصف

const std::string & Description() const

تعرض ملخّصًا أنشأه الخادم لحالة المطابقة

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

HasData

bool HasData() const

صحيح إذا كان هذا الكائن يحتوي على بيانات تم تعيينها أثناء منعطف سابق.

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

HasPreviousMatchData

bool HasPreviousMatchData() const

صحيح إذا كان هذا هو الدور الأول لإعادة المطابقة، ويجب أن تعرض البيانات من القيمة Valid السابقة القيمة "true" لكي تكون هذه الدالة قابلة للاستخدام.

HasRematchId

bool HasRematchId() const

تعرض القيمة "صحيح" إذا تم مطابقة هذه المطابقة.

Id

const std::string & Id() const

تعرض معرّفًا يعرّف TurnBasedMatch بشكل فريد.

استخدِمها مع TurnBasedMultiplayerManager::FetchMatch لاسترداد هذه المطابقة في وقت لاحق. صالحة يجب أن تعرض القيمة "صحيح" لهذه الدالة لتكون قابلة للاستخدام.

LastUpdateTime

Timestamp LastUpdateTime() const

عرض الوقت الذي تم فيه آخر تعديل على TurnBasedMatch (يتم التعبير عنه بالمللي ثانية منذ حقبة Unix).

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

LastUpdatingParticipant

MultiplayerParticipant LastUpdatingParticipant() const

عرض المشارك الذي عدَّل هذه المطابقة مؤخرًا.

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

العدد

uint32_t Number() const

رقم يشير إلى عدد التطابقات التي سبقت هذا الرقم عن طريق إعادة المطابقة.

يتم ضبطها على 1 في أوّل مباراة، وزيادة قيمتها بمقدار واحد في كل مباراة أخرى.

ParticipantResults

const gpg::ParticipantResults & ParticipantResults() const

يعرض نتائج المطابقة.

يمكن تحديد النتائج من خلال TurnBasedMultiplayerManager::TakeMyTurn وTurnBasedMultiplayerManager::FinishDuringMyTurn ودوال أخرى ذات صلة. استخدام ParticipantResults().WithResult(...) دائمًا لإنشاء عنصر ParticipantResults جديد متوافق مع أي عناصر حالية صالحة يجب أن تعرض القيمة "صحيح" لهذه الدالة لتكون قابلة للاستخدام.

مشارك

const std::vector< MultiplayerParticipant > & Participants() const

خط متّجه لجميع المشاركين في هذه المباراة.

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

PendingParticipant

MultiplayerParticipant PendingParticipant() const

عرض المشارك الذي دوره لتحديث هذه المطابقة.

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

PreviousMatchData

const std::vector< uint8_t > & PreviousMatchData() const

البيانات من المطابقة السابقة، إذا كانت HasPreviousMatchData()

لا يمكن طلب البيانات إلا إذا كانت القيمة Valid هي القيمة "true".

RematchId

const std::string & RematchId() const

عرض رقم تعريف المطابقة الذي يمثل إعادة مطابقة لهذه المطابقة، إن توفرت.

الحالة

MatchStatus Status() const

يعرض حالة المطابقة للمشارك المحلي.

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

SuggestedNextParticipant

MultiplayerParticipant SuggestedNextParticipant() const

دالة مساعد تختار مشاركًا صالحًا من مجموعة المشاركين المنضمين واللازمين والمطابقة التلقائية.

إذا تم استخدام هذه الدالة دائمًا لتحديد المشارك التالي، فسيستمر التشغيل من خلال جميع المشاركين بالترتيب، مع التكرار إذا لزم الأمر. يجب استدعاء هذه الدالة فقط إذا كانت Status() هي MatchStatus::MY_TURN، لأنّ هذه هي المرة الوحيدة التي يمكن فيها استخدام نتيجة هذه الدالة بشكل مفيد. إذا تم استدعاؤها بشكل غير صحيح، ستعرض هذه الدالة مشاركًا غير صالح (MultiplayerParticipant::Valid() == false).

TurnBasedMatch

 TurnBasedMatch()

TurnBasedMatch

 TurnBasedMatch(
  std::shared_ptr< const TurnBasedMatchImpl > impl
)

تنشئ TurnBasedMatch من shared_ptr إلى TurnBasedMatchImpl.

مخصص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.

TurnBasedMatch

 TurnBasedMatch(
  const TurnBasedMatch & copy_from
)

تنشئ نسخة من TurnBasedMatch حالية.

TurnBasedMatch

 TurnBasedMatch(
  TurnBasedMatch && move_from
)

يؤدي هذا الإجراء إلى نقل عنصر TurnBasedMatch حالي.

صحيح

bool Valid() const

تعرض القيمة true إذا تمت تعبئة TurnBasedMatch بالبيانات.

يجب عرض القيمة true لدوال getter على كائن TurnBasedMatch (Id، CreationTime، إلخ...) لتكون قابلة للاستخدام.

الصيغة

uint32_t Variant() const

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

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

الإصدار

uint32_t Version() const

رقم تعريف متزايد بشكل صارم، ويتم تعديله في كل مرة يتم فيها تعديل المطابقة.

operator=

TurnBasedMatch & operator=(
  const TurnBasedMatch & copy_from
)

يمكنك تعيين TurnBasedMatch هذا عن طريق النسخ من ملف آخر.

operator=

TurnBasedMatch & operator=(
  TurnBasedMatch && move_from
)

تعيِّن TurnBasedMatch هذه من خلال نقل عنصر آخر إليها.