> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/ggwp-client-sdk/no/yin-sheng-vivox/unity-ssrtono.md).

# Unity SSRとの統合

## 概要

お願いします [こちらを参照してください](/jp/ggwp-client-sdk/no/yin-sheng-vivox/vivox-unity-ssr-vs-ggwp-sdk.md) Unity SSR + GGWP との一般的な統合フローについて。

SSR に関する Unity のドキュメントからの関連リンクをいくつかご紹介します：

* [サーバーサイド録音](https://docs.unity.com/ugs/en-us/manual/vivox-unity/manual/Unity/server-side-recording/ssr-overview)
* [開発者向けドキュメント](https://docs.vivox.com/v5/general/core/5_19_0/en-us/Default.htm#Core/developer-guide/server-side-recording/ssr-overview.htm)
* [Unity Services Web API ドキュメント](https://services.docs.unity.com/ssr/v2/)

## API 要件

Vivox の録音は SSR API 呼び出しを通じてトリガーする必要があります。これは、ゲーム内の音声セッション中に一定の頻度で、または試合終了時などのイベントで実行できます。適切な SSR トリガー戦略の設定については、モデレーションの目標に応じて Vivox 担当者にお問い合わせください。

SSR API 呼び出しを行うには、以下の入力が必要です：

<table><thead><tr><th width="122.23828125">認証情報</th><th>ソース</th><th>用途</th></tr></thead><tbody><tr><td>組織 ID</td><td>Unity ダッシュボード → Vivox → Config ページ</td><td>あなたのゲームに紐づく組織 ID</td></tr><tr><td>プロジェクト ID</td><td>上記と同じです。</td><td>あなたのゲームに割り当てられたプロジェクト ID</td></tr><tr><td>アクセストークン</td><td>上記と同じです。</td><td>JWT の署名に使用する共有シークレット</td></tr><tr><td>チャネルセッション ID</td><td>ユーザーがチャネルに参加した時点で、実行時に取得します</td><td>録音対象の特定セッションを指定するために使用します</td></tr><tr><td>AWS アクセスキー</td><td>GGWP から提供されます</td><td>保存用の S3 バケットへのアクセス</td></tr><tr><td>AWS シークレット</td><td>GGWP から提供されます</td><td>保存用の S3 バケットへのアクセス</td></tr><tr><td>S3 バケット名</td><td>GGWP から提供されます</td><td>音声録音を保存するため</td></tr></tbody></table>

## SSR を起動するサンプルスクリプト

このスクリプトは、直近 15 分間の音声データの録音を開始します。

```python
import requests

ORG_ID = "UNITY_ORG_ID"
PROJECT_ID = "UNITY_PROJECT_ID"
ACCESS_TOKEN = "UNITY_ACCESS_TOKEN"
CHANNEL_SESSION_ID = "UNITY_SOMETHING_LIKE_sip:confctl-g-xxxx@mtu1xp.vivox.com"
ACCESS_KEY_ID = "GGWP_AWS_KEY"
SECRET_KEY = "GGWP_AWS_SECRET"

# AWS S3 の設定
S3_BUCKET = "GGWP_BUCKET"

url = f"https://vivox.services.api.unity.com/ssr/v2/organizations/{ORG_ID}/projects/{PROJECT_ID}/monitor"

headers = {
    "Authorization": f"Basic {ACCESS_TOKEN}",
    "Content-Type": "application/json"
}

payload = {
  "targetUri": CHANNEL_SESSION_ID,
  "history": 15,
  "callbackUrl": "https://something.somthing",
  "callbackKey": "test-123",
  "storageOptions": {
    "provider": "aws",
    "credentials": {
      "bucket": S3_BUCKET,
      "accessKeyId": ACCESS_KEY_ID,
      "secretAccessKey": SECRET_KEY
    }
  }
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 202:
    print("✅ SSR の開始に成功しました。")
    print(response.json())
else:
    print(f"❌ SSR の開始に失敗しました: {response.status_code}")
    print(response.text)
```