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) { // ... } }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961