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 هذا (يتم التعبير عنه بالمللي ثانية منذ حقبة Unix).
Data() const
const std::vector< uint8_t > &
عرض بيانات المطابقة إذا كانت قيمة HasData() صحيحة.
Description() const
const std::string &
تعرض ملخّصًا أنشأه الخادم لحالة المطابقة.
HasData() const
bool
صحيح إذا كان هذا الكائن يحتوي على بيانات تم إعدادها أثناء دوران سابق.
HasPreviousMatchData() const
bool
صحيح إذا كان هذا هو المنعطف الأول في إعادة المطابقة، ويجب أن تعرض البيانات من الحالة صالحة السابقة true حتى تكون هذه الدالة قابلة للاستخدام.
HasRematchId() const
bool
تعرِض القيمة "صحيح" إذا تمت إعادة مطابقة هذه المطابقة.
Id() const
const std::string &
تعرض معرّفًا يعرّف TurnBasedMatch بشكل فريد.
LastUpdateTime() const
تعرض الوقت الذي تم فيه آخر تعديل على TurnBasedMatch هذا (يتم التعبير عنه بالمللي ثانية منذ حقبة يونكس).
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

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

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

CreatingParticipant

MultiplayerParticipant CreatingParticipant() const

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

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

CreationTime

std::chrono::milliseconds CreationTime() const

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

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

البيانات

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

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

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

الوصف

const std::string & Description() const

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

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

HasData

bool HasData() const

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

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

HasPreviousMatchData

bool HasPreviousMatchData() const

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

HasRematchId

bool HasRematchId() const

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

رقم التعريف

const std::string & Id() const

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

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

LastUpdateTime

Timestamp LastUpdateTime() const

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

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

LastUpdatingParticipant

MultiplayerParticipant LastUpdatingParticipant() const

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

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

العدد

uint32_t Number() const

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

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

ParticipantResults

const gpg::ParticipantResults & ParticipantResults() const

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

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

مشارك

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

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

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

PendingParticipant

MultiplayerParticipant PendingParticipant() const

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

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

PreviousMatchData

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

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

ولا يمكن استدعاء الدالة إلا إذا كانت كلمة صالحة ذات قيمة صحيحة.

RematchId

const std::string & RematchId() const

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

الحالة

MatchStatus Status() const

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

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

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 بالبيانات.

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

الصيغة

uint32_t Variant() const

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

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

الإصدار

uint32_t Version() const

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

r=or

TurnBasedMatch & operator=(
  const TurnBasedMatch & copy_from
)

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

r=or

TurnBasedMatch & operator=(
  TurnBasedMatch && move_from
)

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