UnityCloudDiagnostics
Multiplayer 服务

Unity Integrations

Unity Integrations 允许在开发工作流程中将以下 Unity 服务连接到非 Unity 工具:

To add an integration, you must be an Owner or Manager on the Project. For information on assigning roles, see the Members & Groups section of Managing your Organization.

Unity Integrations 支持以下非 Unity 工具:

  • Webhooks:用户定义的回调,允许 Unity 将 POST 请求发送到外部服务。
  • Discord:通过 Discord 定义的 Webhook 向您团队的 Discord 通道发送通知。
  • Slack:通过 Slack 定义的 Webhook 向您团队的 Slack 通道发送通知。
  • JIRA:使用 JIRA 定义的 Webhook 创建或更新 JIRA 票据。

Number of integrations

Unity Personal limits users to one integration for all events, but multiple Unity services can use that integration. Unity Teams, Plus, and Pro users can have up to 100 integrations. If your Unity Teams, Pro, or Plus subscription expires, Unity keeps all of your current integrations, but automatically disables them. If this happens, you can still sign into the Unity Services Dashboard and enable a single integration.

Adding an integration

To add an integration to your workflow:

1.登录 Unity Services Dashboard。 2. Select the Project that you want to add an integration to. 3. In the left navigation bar, click Settings, then click Integrations. 4. Click the NEW INTEGRATION button. 5. In the New Integration dialog box: 1. Select the program to integrate with, then click the NEXT button to configure the integration. 2. Select the events that trigger the action the integration takes, then click the NEXT button.

If you select a webhook or JIRA integration, the Configure options step opens. Otherwise, the configurations screen for the selected tool opens.

Webhook integrations

To configure a webhook integration, you must supply the following information:

Parameter 描述
Display Name A name to identify the integration in the integrations list.
Webhook URL 从 Unity 服务接收 Webhook POST 请求的服务器端点的 URL。
Authentication Secret 接收端应用程序的客户端密钥。
Content Type 内容的 MIME 类型。从下拉菜单中选择数据的内容类型。
Disable SSL/TLS Verification 勾选此复选框可禁用 SSL/TLS 安全证书的验证。
验证 SSL/TLS 证书有助于确保数据安全发送到上方的 Webhook URL。建议不要启用此选项,因此只有在您完全清除自己目的的情况下才启用此选项。

Discord integrations

To configure Discord integrations, Unity calls an app that uses the Discord API to register a webhook to a Discord channel. If you do not have a Discord server, see How do I create a server? in the Discord documentation.

重要信息:必须在要集成的帐户上启用 Webhooks。

要完成配置,请执行以下操作:

  1. Sign in to your Discord account.
  2. From the Select a server drop-down menu, select your Discord server.
  3. From the Select a channel menu, select a channel to post notifications to.
  4. Click the Authorize button.

Slack integrations

To configure Slack integrations, Unity calls an app that uses the Slack API to register a webhook to a Slack channel. If you do not have a Slack server, see Create a Slack workspace in the Slack documentation.

要完成配置,请执行以下操作:

1.登录 Slack 帐户。 2.在应用程序的右上角,选择 Slack 工作空间。 3. From the Post to drop-down menu, select the Slack channel to post notifications to. 4. Click the Authorize button.

JIRA integration

The Unity JIRA integration allows you to interact with JIRA as follows:

  • Cloud Diagnostics: Create a new issue when you receive a report. Unity creates the issue with one of the following labels: unity-user-report, unity-crash-report, or unity-exception-report. You must have permission to create an issue and modify the label column for these integrations to work.
  • Collaborate:在 Collaborate 中发布更改时,为现有问题添加注释。

To configure a JIRA integration for Collaborate or Cloud Diagnostics, you must supply the following information:

Parameter 描述
Display Name A name to identify the integration in the integrations list.
JIRA Site URL JIRA 实例的 URL。
JIRA Username 有权将更新发布到 JIRA 实例的帐户的用户 ID。
JIRA REST API Token 用于验证向 JIRA 服务器发送的集成请求的 API 令牌。有关如何创建令牌的说明,请参阅 Atlassian 的文档

输入 JIRA 实例的信息后,必须为 Cloud Diagnostics 提供以下附加信息:

Parameter 描述
Create Issues In This Project 选择要在其中创建问题的项目。
Mark Incoming Issues As 选择要将报告记录为的问题类型。

在 Collaborate 中进行更改时,通过在提交消息中引用问题标识来更新与 JIRA 相关的问题。例如,通过“I fixed the crashes caused by ISS–42”向问题“ISS–42”添加发布详情。

Editing an integration

To edit an existing integration:

1.登录 Unity Services Dashboard。 2. Select the Project that you want to edit an integration for. 3. In the left navigation column, click Settings, then click Integrations. 4. Click EDIT next to the integration to modify.

The types of edits you can make depend on the integration. For Slack and Discord integrations, you can update the display name or delete the integration.

For webhook and JIRA integrations, you can modify any of the configuration parameters that you supplied when you created them.

Enabling or disabling an integration

To enable or disable an integration from the dashboard.

1.登录 Unity Services Dashboard。 2. Select the Project that you want to edit an integration for. 3. In the left navigation column, click Settings, then click Integrations. 4. Click the toggle in the Status column to quickly enable or disable an integration.

UnityCloudDiagnostics
Multiplayer 服务