Unity Integration

Unity Integration を利用すると、開発ワークフロー内の以下の Unity Services を Unity 以外のサービスと接続できます

• Cloud Build
• Cloud Diagnostics

Integration を設定するには、プロジェクトのオーナーまたはマネージャーであることが必要です。ロールの割り当てに関する情報は、Organization の管理 の Members & Groups セクションを参照してください。

Unity Integration は以下の外部サービスをサポートします。

• Webhooks: Unity から外部サービスへ POST リクエストの送信を可能にするユーザー定義のコールバック。
• Discord: Discord によって定義された Webhook を通してチームの Discord チャンネルに通知を送信します。
• Slack: Slack によって定義された Webhook を通してチームの Slack チャンネルに通知を送信します。
• Email: メールでチームに通知を送信します。
• JIRA: JIRA 定義の Webhook を使用して JIRA チケットを作成または更新します。
• Trello: Trello カードを作成しコメントを記述します。

Integration の制限

Unity Personal のユーザーはすべてのイベントに対して Integration を 1 つに制限されますが、複数の Unity サービスでこの 1 つの Integration を使用できます。Unity Teams、Plus、Pro のユーザーは最大 100 の Integration を利用できます。Unity Teams、Pro、Plus サブスクリプションの有効期限が切れた場合、現在のすべての Integration は維持されますが、自動的にそれらは使用不可になります。このような場合は、Unity Services Dashboard にサインインして Integration を 1 つ有効にすることができます。

Integration の追加

ワークフローに Integration を追加するには、以下を行います。

1. Unity Services Dashboard にサインインします。
2. Integration を加えるプロジェクトを選択します。
3. 左側のナビゲーションバーで、Settings > Integrations を選択します。
4. Integration ダッシュボードが表示されます。NEW INTEGRATION ボタンをクリックします。
   
   
5. 有効にしたい Integration を選択します。
6. Integration をトリガーするイベントを選択し、NEXT ボタンをクリックします。
7. Integration オプションを設定します。これらのオプションは、選択した Integration によって異なります。詳細は後述のセクションで説明します。

Webhook の Integration

Webhook の Integration を設定するには、以下の情報を入力します。

パラメーター	説明
Display Name	Integration リストで Integration を識別するための名前。
Webhook URL	Unity からの Webhook POST リクエストを受けとるサーバーエンドポイントの URL
Authentication Secret	受信側アプリケーションのクライアントシークレット
Content Type	コンテンツの MIME タイプ。ドロップダウンからデータのコンテンツタイプを選択します。
Disable SSL/TLS Verification	SSL/TLS セキュリティ証明書の検証を無効にするには、このチェックボックスにチェックを入れます。 SSL/TLS 証明書を検証すると、データを上記の Webhook URL に安全に送信できます。そのため、このオプションを有効にすることは推奨されません。それを完全に理解している場合にのみ、このオプションをチェックしてください。

Discord の Integration

Discord の Integration を設定するために、Unity は Discord API を使用するアプリケーションを呼び出して Webhook を Discord チャンネルに登録します。Discord サーバーがない場合は、Discord のドキュメント サーバーの作成の仕方 を参照してください。

重要 : 統合するアカウントで Webhook を使用可能にする必要があります。

以下の手順で設定します。

1. 新しい Discord Integration を作成し、そのイベントを選択します。
2. NEXT ボタンをクリックします。Discord ログイン画面でサインインします。
3. CONNECT TO DISCORD ダイアログ画面が表示されます。
   
   
4. Select a server ドロップダウンメニューから、Discord サーバーを選択します。
5. Select a channel メニューから、通知をポストするチャンネルを選択します。
6. Authorize ボタンをクリックします。

Slack の Integration

Slack の Integration を設定するために、Unity は Slack API を使用するアプリケーションを呼び出して Webhook を Slack チャンネルに登録します。

新しいSlack Integration を作成し、表示するイベントを設定した後に、Unity に Slack サーバーにアクセスするための承認を与える必要があります。

Slack サーバーがない場合は、Slack ワークスペースを作成する を参照してください。

以下の手順で設定します。

1. Slack アカウントにサインインします。
2. アプリケーションの右端で Slack Workspace を選択します。
3. Post to ドロップダウンメニューから、通知を送信するSlackチャンネルを選択します。
4. Authorize ボタンをクリックします。

Email の Integration

Email の Integration は、プロジェクトに指定されたイベントが発生したときにチームメンバーに通知します。

1. ダッシュボードから Email Integration を作成し、イベントメニューを表示します。
2. 電子メール通知を受け取りたいイベントを選択し、NEXT ボタンをクリックします。
   ノート: Cloud Build は電子メール通知設定を個別に処理します。イベントメニューの下にある here のリンクをクリックして設定できます。
3. 通知を送信するチームメンバーを選択します。
4. チームメンバーが受信するメールを将来追加する新しいチームメンバーも自動的に受信できようにしたい場合は、Send email to new team members を選択します。

JIRA の Integration

Unity JIRA の Integration を使用すると、以下のように JIRA と相互作用できます。

• Cloud Diagnostics: レポートを受け取るときに新しい問題を作成します。Unity は unity-user-report、unity-crash-report、unity-exception-report のいずれかのラベルで問題を作成します。問題を作成し、これらのインテグレーションのラベル列を変更するには権限が必要です。

JIRA インスタンスの情報を入力したら、Cloud Diagnostics に以下の情報も入力する必要があります。

パラメーター	説明
Create Issues In This Project	問題を作成するプロジェクトを選択します。
Mark Incoming Issues As	ログするレポートの問題のタイプを選択します。

Trello の Integration

Unity Trello Integrationには以下の機能があります。

• Cloud Diagnostics: ユーザーレポートを受信すると、Unity は自動的に新しいカードを作成し、ボードに追加します。

To configure a Trello Integration for Cloud Diagnostics:

1. Unity Services Dashboard で Trello Integration を作成します。これを行うには、ダッシュボードからプロジェクトを選択し、Settings > Integrations に進み、ウィンドウから Trello Integration を選択します。
2. プロジェクトを統合したいサービスやイベントを選択して、Next を選択します。
3. Unity は Trello へのサインインを促し、Trello ボードに変更を加えるための許可を求めます。この許可は、Unity がカードの作成、更新、コメントをするために必要です。
4. Unity がどのボードやリストに投稿するかなど、Integrationの概要を設定ページに記入し、設定を保存します。

既存の Integration の管理

既存の Integration を管理するには、以下を行います。

1. Unity Services Dashboard にサインインします。
2. 編集したい Integration を持つプロジェクトを選択します。
3. 左側のナビゲーションバーで、Settings > Integrations を選択します。

既存の Integration を編集または削除するには、変更したい Integration の隣にある EDIT をクリックします。作成できる編集のタイプは Integration によって異なります。

• Slack と Discord の Integration では、表示名の更新や、Integration の削除を行えます。
• Webhook と JIRA の Integration では、作成時に指定した設定パラメーターを変更できます。

既存の Integration を有効または無効にするには、Status ボタンで Integration を有効または無効にします。