StateVoice Cloud 導入ガイド

対応環境

音声サーバーと課金基盤は運営側が管理します。お客様側では、次の環境をご用意ください。

• CarbonまたはOxideのいずれかを導入したRust Dedicated Server
• Windows Server 2025 x64、またはUbuntu 24.04 LTS x86-64
• StateVoice CloudのHTTPS（TCP 443）とgRPC（TCP 17701）への接続
• Windowsの管理者権限、またはLinuxのroot権限

1. StateVoice Consoleを開く

1. Paymenterへログインし、有効なStateVoiceサービスを開きます。
2. StateVoice Consoleを選択します。
3. Consoleに表示される契約枠と登録済みRustサーバー数を確認します。

Consoleのサインインリンクは一回限りで、発行から2分後に失効します。失効した場合はPaymenterのサービス画面から開き直してください。

2. Rustサーバーを登録してセットアップZIPを取得する

ConsoleのRegister Rust serverで、画面表示用の名前と、テナント内で一意のAdapter ID（例: rust-primary）を入力してCreate enrollmentを押します。

ダウンロードしたZIPにはwindows/とlinux/があり、それぞれにインストーラー、共通のStateVoice.cs、暗号化済み.svbundleが入っています。

bundleパスフレーズは一度しか表示されず、ZIPにも含まれません。ZIPとパスフレーズを有効期限内に安全な場所へ保存してください。紛失・失効時はGenerate packageで再発行できます。

3. Windows Serverへインストール

ZIPを展開し、windowsディレクトリで管理者としてPowerShellを開きます。bundle名とRustサーバールートは実際の値に置き換えてください。

.\statevoice-setup.exe rust install `
  --bundle .\rust-primary.svbundle `
  --rust-root C:\RustServer `
  --assets-dir $PWD

CarbonまたはOxideのプラグイン、ローカルAdapter、StateVoiceAdapter Windowsサービス、資格情報のアクセス制御が自動設定されます。両方のフレームワークが存在する場合は、--framework carbonまたは--framework oxideを追加します。

インストール確認

.\statevoice-setup.exe rust doctor --rust-root C:\RustServer
Get-Service StateVoiceAdapter

4. Ubuntuへインストール

ZIPを展開し、Rustサーバーを実行するLinuxユーザー名を指定してrootで実行します。

sudo ./statevoice-setup rust install \
  --bundle ./rust-primary.svbundle \
  --rust-root /home/steam/rustserver \
  --service-user steam \
  --assets-dir "$PWD"

プラグイン、/opt/statevoice/adapterのAdapter、hardened statevoice-adapter.service、永続状態とログのディレクトリ、資格情報の権限が自動設定されます。

インストール確認

sudo ./statevoice-setup rust doctor --rust-root /home/steam/rustserver
sudo systemctl status statevoice-adapter.service

5. 接続を確認する

1. RustサーバーとCarbonまたはOxideを起動・再起動します。
2. StateVoice Consoleで登録サーバーとAdapter heartbeatを確認します。
3. Rustへ参加し、チャットで/voiceを実行してペアリングコードを発行します。
4. StateVoice Companionへコードを入力し、マイクを明示的にオンにして音声接続を確認します。

トラブルシューティング

トークン、bundle、秘密鍵、プラグイン設定のBootstrap Tokenを、サポートチケットや公開チャットへ貼り付けないでください。