文档

​
​

Development

User Acquisition

Monetization

工业

Multiplayer Services SDK

All Services

Multiplayer Services SDK

此页面不支持所选语言。
Multiplayer
​
​
Multiplayer Services SDK
  • Overview
  • Get started
  • Use multiplayer sessions
  • Manage sessions
  • Connect players through a relay
  • Networking
  • Matchmaking
    • Get started with matchmaking
    • Manage and configure matchmaking
    • Matchmaker troubleshooting
    • Integrations with other UGS services
    • Deploy Matchmaker configurations
      • Deploy a Matchmaker Environment
      • Deploy a Matchmaker Queue
  • Monitor and debug sessions
  • Tutorials
  • Reference
  1. Multiplayer Services SDK

Deploy a Matchmaker queue

Use the Deployment window in the Unity Editor to deploy a Matchmaker queue.
阅读时间3 分钟
最后更新于 16 天前

A queue represents a predefined logical separation of matchmaking tickets within an environment. A queue has one or more pools. You can deploy a Matchmaker queue configuration directly from the Unity Editor.

Prerequisites

Before you start, ensure you have done the following:
  1. Set up a Unity Dashboard account with at least one project.
  2. Linked your cloud project to the active Unity project.

Install the required packages

To enable the integration between the Multiplayer Services SDK and Deployment, install the following packages:
  1. In the Unity Editor, navigate to Window > Package Manager.
  2. Select Unity Registry.
  3. Search for Deployment.
  4. Select Install.
  5. Still in the Unity Registry, search for Multiplayer Services.
  6. Select Install.

Set up the Deployment window

You can deploy Matchmaker queue configurations to your cloud environment using the Deployment window. After you install the Deployment package, you can access the Deployment window from the Unity Editor by selecting Services > Deployment.
Before you can use the Deployment window, you first need to select the environment where you want to deploy. To select the deployment environment, do the following:
  1. In the Unity Editor, select Services > Deployment.
  2. Select Deployment Settings.
  3. In the Environments window that opens, select an Editor Environment.

Create a Matchmaker queue configuration

To create an editable Queue configuration:
  1. In the Unity Editor's Project window, right-click (macOS: Ctrl+click) in the
    Assets
    folder.
  2. Select Create > Services > Matchmaker Queue Config.

Edit a Matchmaker queue configuration

To edit the Matchmaker queue configuration either directly from the Unity Editor or from an IDE of your choice, do the following:
  1. In the Project window, select the
    MatchmakerQueue
    ScriptableObject you created previously.
  2. In the Inspector window, edit the properties of the queue configuration for the Matchmaker Queue (Matchmaker Asset). Alternatively, you can open the asset file in your favorite IDE and edit the contents manually.
注意
The recommended best practice is to configure file type associations (Unity Services Web API Docs) in your IDE to work with Matchmaker files. This makes authoring the files significantly easier by providing autocomplete functionality in your preferred IDE. Refer to the Matchmaker queue schema.
Refer to Filters for more information about the queue configuration.

Deploy the Matchmaker queue configuration

To deploy the Matchmaker queue configuration:
  1. In the Deployment window, double-click on the queue configuration.
  2. Right-click (macOS: Ctrl+click) a queue configuration, then select Deploy.
  3. Select the queue you're ready to deploy.
  4. Select Deploy Selected.
If your configuration assets don't appear in the Deployment window, make sure you activate domain reloading.
To activate domain reloading:
  1. In the Unity Editor, go to Edit > Project Settings.
  2. Select Editor.
  3. Verify that the Enter Play Mode Settings > When entering Play Mode setting is Reload Domain and Scene or Reload Domain only.

Additional resources

  • Matchmaker rule samples
  • Matchmaker queues and pools
  • Matchamker JSON queue schema
  • Matchmaker Admin API

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • Prerequisites

    • Install the required packages

    • Set up the Deployment window

    • Create a Matchmaker queue configuration

    • Edit a Matchmaker queue configuration

    • Deploy the Matchmaker queue configuration

    • Additional resources


报告此页面的问题