Version: 2019.4
语言: 中文
Method group is Obsolete

NetworkMatch.ListMatches

切换到手册
Obsolete public Coroutine ListMatches (int startPageNumber, int resultPageSize, string matchNameFilter, bool filterOutPrivateMatchesFromResults, int eloScoreTarget, int requestDomain, DataResponseDelegate<List<MatchInfoSnapshot>> callback);

参数

startPageNumber将在返回结果中列出的当前页面。
resultPageSize所请求页面的大小。这决定了传入回调的匹配列表中包含的最大匹配数量。
matchNameFilter文本字符串名称筛选器。这是针对当前处于活动状态的匹配名称的部分通配符搜索，并且可视为等同于 *<matchNameFilter>* 的匹配，其中包含此处提供的完整字符串的任何结果都将出现在结果集中。
filterOutPrivateMatchesFromResults指示响应是否应包含私有匹配（指有密码保护的匹配）的布尔值。
eloScoreTarget将分组的匹配列表结果的 Elo 得分目标。如果使用了该参数，则应将其设置为列出匹配的客户端的 Elo 等级，从而结果将与玩家的技能等级更匹配。如未使用，则可以将其与函数中的所有其他 Elo 引用（如 NetworkMatch.CreateMatch 或 NetworkMatch.JoinMatch）一起设置为 0。
requestDomain此请求的请求域。只有同一域中的请求可以相互连接。例如，如果使用域 1 创建 NetworkMatch.CreateMatch，则只有也指定了域 1 的 ListMatches 才能找到该匹配。使用此值来接收不同（可能不兼容）的客户端版本。
callback在 MatchMaker 上完成此调用后调用的回调。

返回

Coroutine 这是一个异步函数，将在未来某个时刻（即协程结束与服务后端的通信时）完成。

描述

用于列出 MatchMaker 中正在进行的匹配的函数。

NetworkMatch.ListMatches 函数返回当前活动匹配的基于页面的结果，这些匹配与提供给该函数的参数一致。

您最初应该使用从 0 开始的页码以及合理的页面大小（例如，10）来调用此函数。页面过大会延长下载与这些匹配相关的信息所需的时间。回调将使用包含以 resultPageSize 为最多匹配数的数据进行调用（例如，如果当前 startPageNumber 为 3，resultPageSize 为 5，则传入回调的数据将会是结果列表中对应于结果 15-20 的匹配）。之后您可以重复调用此函数，增加 startPageNumber 并保持固定的 resultPageSize 和 matchNameFilter，以使结果保持半稳定状态（您可以在调用此函数时创建或销毁匹配，这将反映在结果中。）

using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.Networking.Match;
using System.Collections.Generic;

public class ExampleScript : MonoBehaviour
{
    void Start()
    {
        NetworkManager.singleton.StartMatchMaker();
        NetworkManager.singleton.matchMaker.ListMatches(0, 10, "", true, 0, 0, OnMatchList);
    }

    public void OnMatchList(bool success, string extendedInfo, List<MatchInfoSnapshot> matches)
    {
        // ...
    }
}

Did you find this page useful? Please give it a rating:

版权所有 © 2020 Unity Technologies. Publication 2019.4
教程社区答案知识库论坛Asset Store商标和使用条款法律条款隐私政策Cookie不要出售或分享我的个人信息