クイックスタート
5–10分で「更新履歴」「バナー」「バグ報告」が動くところまで進めます。
0. 前提
- Unity: 6.3（`6000.3.x`）
- UI: UI Toolkit（`UIDocument`）
- 対象: Windows / macOS
1. SDKを導入（ZIP）
- `/sdk/unity/download/` からZIPをダウンロード
- ZIPを解凍し、フォルダ `com.arito.liveops-sdk` を任意の場所に置く
- Unity → Package Manager → 「Add package from disk...」
- `com.arito.liveops-sdk/package.json` を選択して追加
2. SamplesをImport
- Unity → Package Manager → Arito LiveOps SDK を選択
- Samples から `Changelog Demo` / `Banner Demo` / `BugReport Demo` を Import
ここで詰まったら
Importが見当たらない場合、Package Managerの検索で `Arito LiveOps SDK` を探してください。
（推奨）設定ウィザードで検証
SDK同梱の「Setup Wizard」を使うと、URL/slugの間違い・JSON形式・必須フィールド不足をその場で検出できます。 失敗時はConsoleに1行で原因が出ます。
- Samples から `Setup Wizard (UI Toolkit)` を Import
- Sceneに `UIDocument` を置き、`SetupWizard.uxml` を割り当て
- `LiveOpsSetupWizardController` を追加して `Run checks`
3. Changematic（更新履歴）を動かす
- Changematicでプロジェクトを作成し、公開JSON URLを取得
- デモのScene（`UIDocument`）に `ChangelogViewController` を付ける
- `historyJsonUrl` にURLを設定して再生
まずはデモURLで試す（おすすめ）
すぐ動作確認したい場合は、下記の読み取り専用デモJSONを `historyJsonUrl` に貼り付けてください。
`https://changematic.arito.group/history/demo/demo.json`
`https://changematic.arito.group/history/demo/demo.json`
公開JSON URL
`https://changematic.arito.group/history/<teamSlug>/<projectSlug>.json`
表示キー
JSONは配列で、各要素のキーは自由です。`itemTitleKey` / `itemBodyKey` を使って表示キーを合わせます。
4. Bannermatic（バナー/動画）を動かす
- Bannermaticでプロジェクトを作成し、バナーを登録（画像/動画mp4）
- 公開JSON URLを取得
- デモのSceneに `BannerRotatorController` を付ける
- `bannerJsonUrl` を設定して再生
まずはデモURLで試す（おすすめ）
すぐ動作確認したい場合は、下記の読み取り専用デモJSONを `bannerJsonUrl` に貼り付けてください。
`https://bannermatic.arito.group/banner/demo/demo.json`
`https://bannermatic.arito.group/banner/demo/demo.json`
公開JSON URL
`https://bannermatic.arito.group/banner/<teamSlug>/<projectSlug>.json`
バナーの参照先
SDKは `data.media.url`（または `media.url`）を優先して画像/動画を検出します（mp4想定）。
5. Formmatic（バグ報告）を動かす
- Formmaticで公開フォームを作成
- デモのSceneに `BugReportDemoController` を付け、`formSlug` を設定
- `gameApiSecret` を設定
- Open Game Form でWebView表示
トークン方式
Game APIでトークンを取得し、`/g/?token=...` をWebViewで開きます。
WebViewデモ
`FormmaticWebViewController` を使うと、UniWebViewでの表示 + 戻る/閉じるUIまで用意できます。
`Samples~/FormmaticWebViewDemo` をそのまま使うと早いです。
`Samples~/FormmaticWebViewDemo` をそのまま使うと早いです。