Unity Cloud Diagnostics
멀티플레이어 서비스(Multiplayer Services)

Unity 통합

Unity 통합을 이용하면 개발 워크플로에서 다음 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 통합은 다음과 같은 비 Unity 툴을 지원합니다.

  • Webhooks: A user-defined callback that allows Unity to send POST requests to an external service.
  • Discord: Send notifications to your team’s Discord channel through a Discord-defined webhook.
  • Slack: Send notifications to your team’s Slack channel through a Slack-defined webhook.
  • Email: Send notifications to your team by Email.
  • JIRA: Create or update JIRA tickets using a JIRA-defined webhook.

Integration limits

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. Sign in to the Unity Services Dashboard.
  2. Select the Project that you want to add an Integration to.
  3. In the left navigation bar, select Settings > Integrations.
  4. The integrations dashboard appears. Click the NEW INTEGRATION button.

    Creating a new Integration in the Developer Dashboard.
  5. Select the Integration you want to enable.
  6. Select the event(s) that you want to trigger the Integration, then click the NEXT button.
  7. Configure the Integration options. These options vary depending on the Integration selected, and are described in detail in the sections below.
Configuring a new tool to Integrate.
Configuring a new tool to Integrate.

Webhook Integrations

To configure a webhook Integration, supply the following information:

Webhook configuration settings.
Webhook configuration settings.
Parameter 설명
표시 이름 A name to identify the Integration in the Integrations list.
웹훅 URL Unity 서비스에서 웹훅 POST 요청을 수신하는 서버 엔드포인트의 URL입니다.
인증 비밀 키 수신하는 애플리케이션의 클라이언트 비밀 키입니다.
콘텐츠 타입 콘텐츠의 MIME 타입입니다. 드롭다운 메뉴에서 데이터의 콘텐츠 타입을 선택하십시오.
SSL/TLS 확인 비활성화 Tick this checkbox to disable verification of SSL/TLS security certificates.
Verifying SSL/TLS certificates helps ensure that your data is sent securely to the above Webhook URL. Turning this option on is not recommended, so only do this if you absolutely know what you’re doing.

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.

Important: You must enable webhooks on the account with which you are integrating.

설정을 완료하는 방법은 다음과 같습니다.

  1. Create a new Discord integration and select its events.
  2. Click the NEXT button. Sign in on the Discord login screen.
  3. The CONNECT TO DISCORD dialog screen appears.

    Configuring a Discord Integration.
  4. From the Select a server drop-down menu, select your Discord server.
  5. From the Select a channel menu, select a channel to post notifications to.
  6. 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.

After creating a new Slack integration and configuring the events that you want to appear, you must authorize Unity to access your Slack server.

Authorizing Unity to connect to your Slack server.
Authorizing Unity to connect to your Slack server.

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.

Email Integrations

Email Integrations notify team members when specified events for your Project occur.

  1. Create an email integration from the dashboard to view the events menu.
  2. Select the events for which you want to receive email notifications, then click the NEXT button.

    Note: Cloud Build handles email notification settings separately. You can configure them by clicking the here link at the bottom of the events menu.
  3. Select the team members for whom you’d like notifications to be sent.
  4. Select Send email to new team members if you’d like team members that you add in the future to automatically receive the emails that other team members receive.
Configuring email Integrations.
Configuring email Integrations.

JIRA Integrations

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: Add a comment to an existing issue when you publish a change in Collaborate.
Configuring a JIRA Integration.
Configuring a JIRA Integration.

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

Parameter 설명
표시 이름 A name to identify the Integration in the Integrations list.
JIRA 사이트 URL The URL of your JIRA instance.
JIRA 사용자 이름 JIRA 인스턴스에 업데이트를 게시할 수 있는 계정의 사용자 ID입니다.
JIRA REST API 토큰 The API token to authenticate Integration requests to your JIRA server. For instructions on how to create a token, see Atlassian’s documentation.

After you have entered the information for your JIRA instance, you must supply the following additional information for Cloud Diagnostics:

Parameter 설명
Create Issues In This Project Select the project in which to create the issues.
Mark Incoming Issues As 보고서를 기록할 문제 타입을 선택합니다.

When you make changes in Collaborate, update JIRA-associated issues by referencing the issue key in your commit message. For example, “I fixed the crashes caused by ISS–42” adds publish details to issue “ISS–42”.

Managing existing Integrations

To manage existing Integrations:

  1. Sign in to the Unity Services Dashboard.
  2. Select the Project with the Integration you want to edit.
  3. In the left navigation column, select Settings > Integrations.

To edit or delete an existing Integration, click EDIT next to the Integration you want 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.

To enable or disable an existing Integration, click the Status toggle to enable or disable the Integration.

Managing Integrations in the Developer Dashboard.
Managing Integrations in the Developer Dashboard.
Unity Cloud Diagnostics
멀티플레이어 서비스(Multiplayer Services)