qBool EndRound( ProtocolCallContext * pCC, const MatchmakeRefereeEndRoundParam & endRoundParam );
Name | Description | |
---|---|---|
in | pCC | Call information. |
in | endRoundParam | Report to send to the server. Sets the results for all round participants in endRoundParam.personalRoundResults . |
Ends a round and sends a report.
Reports the results of the round to the server.
Called when the round has completed.
Stop collecting statistics and summarize statistics when the reports of all participants have been gathered, all participants have disconnected, or one minute has passed after the first report was sent. If this API is called for the first time after the StartRound
function is called, round participants are notified with NotificationEvents::FirstRoundReportReceived
.
When summarizing statistics has completed, a NotificationEvents::RoundSummarized
notification is sent to the round participants.
For more information about the statistics in the report that is sent, see the Programming Manual.
Returns QERROR(MatchmakeReferee, InvalidArgument)
if the personalRoundResults
set in endRoundParam has the size of buffer that exceeds MatchmakeRefereeConstants::STATS_BUFFER_MAX_SIZE
. Returns QERROR(MatchmakeReferee, InvalidArgument)
if the size of PersonalRoundResults
set in endRoundParam is not equal to the number of participants.
Returns QERROR(MatchmakeReferee, RoundNotFound)
if there is no target round to report.
Returns QERROR(MatchmakeReferee, AlreadyExists)
if the round to report has been reported.
Returns QERROR(MatchmakeReferee, RoundArbitrated)
if the summarizing statistics for the round to report have already completed.
Returns QERROR(MatchmakeReferee, RoundNotFound)
if a user is not participating in the round to report.
QERROR(MatchmakeReferee, AlreadyExists)
instead of QERROR(PythonCore, Exception)
if a round has already been reported.
CONFIDENTIAL