NetworkMatch.CreateMatch

public Coroutine CreateMatch (string matchName, uint matchSize, bool matchAdvertise, string matchPassword, string publicClientAddress, string privateClientAddress, int eloScoreForMatch, int requestDomain, DataResponseDelegate<MatchInfo> callback);

参数

matchName	描述此匹配的名称的文本字符串。
matchSize	创建匹配时，配对将使用此值或者您在 https://multiplayer.unity3d.com, 中在线配置的最大大小（以较低者为准）。这样，您就可以为特定游戏指定不同的匹配大小，但仍在在线控制面板中保持总体大小限制。
matchAdvertise	指示此匹配是否应在 NetworkMatch.ListMatches 结果中可用的布尔值。
matchPassword	指示此匹配是否受密码保护的文本字符串。如果是，则尝试加入此匹配的所有客户端都必须提供正确的匹配密码。
publicClientAddress	可选的公用客户端地址。该值存储在配对上并会提供给列出匹配的客户端。该地址应为用于直接通过 Internet 连接到此客户端的网络地址。只有在已知公用地址且配对支持直接连接时，此值才会存在。
privateClientAddress	可选的专用客户端地址。该值存储在配对上并会提供给列出匹配的客户端。该地址应为用于通过局域网直接连接到该客户端的网络地址。只有在配对支持直接连接时，此值才会存在。这可能是一个空字符串，并且不会影响与配对连接或使用 Relay Server 的能力。
eloScoreForMatch	托管所创建匹配的客户端的 Elo 得分。如果已在所有客户端上设置此数值以指示相对技能等级，则此数值用于返回匹配并按对游戏（已提供所列玩家的技能等级）的适合程度由高到低排序。可以在所有客户端上将此值设置为 0，这会禁用 MatchMaker 中的任何 Elo 计算。
requestDomain	此请求的请求域。只有同一域中的请求可以相互连接。例如，如果使用域 1 创建 NetworkMatch.CreateMatch，则只有也指定了域 1 的 ListMatches 才能找到该匹配。使用此值来接收不同（可能不兼容）的客户端版本。
callback	将在此函数完成时调用的回调。无论函数执行成功还是失败，都会进行调用。

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

描述

使用此函数创建一个新匹配。调用此函数的客户端会成为匹配的主机。

创建匹配时，您应该调用此函数并等待调用回调，然后再继续操作。回调将指示调用是否成功，并针对失败情况提供扩展信息。收到响应回调后，您应该使用传入的 MatchInfo 调用 StartHost()。

using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.Networking.Match;

public class ExampleScript : MonoBehaviour
{
    void Start()
    {
        NetworkManager.singleton.StartMatchMaker();
        NetworkManager.singleton.matchMaker.CreateMatch("roomName", 4, true, "", "", "", 0, 0, OnMatchCreate);
    }

    public void OnMatchCreate(bool success, string extendedInfo, MatchInfo matchInfo)
    {
        // ...
    }
}

脚本 API

NetworkMatch.CreateMatch

参数

返回

描述