シーンコレクションとプロファイル
OBS の設定はシーンコレクション(シーンとソースのグループ)とプロファイル(出力、エンコーダー、サービスの設定)の2つに整理されています。このガイドでは、それらの切り替え、映像出力の設定、配信サービスの送信先設定について説明します。
シーンコレクション
| 関数 | 説明 |
|---|
GetSceneCollectionList() | OBS からシーンコレクション一覧を更新する |
SetCurrentSceneCollection(Name) | シーンコレクションを切り替える(OBS が再読み込みされます!) |
CreateSceneCollection(Name) | 新しいコレクションを作成し、そちらに切り替える |
GetCachedSceneCollections() | ローカルにキャッシュされたコレクション名を取得する |
GetCurrentSceneCollectionName() | 現在のコレクション名を取得する(キャッシュ済み) |
警告: シーンコレクションを切り替えると OBS がすべてのソースを再読み込みするため、短時間の中断が発生します。
プロファイル
| 関数 | 説明 |
|---|
GetProfileList() | OBS からプロファイル一覧を更新する |
SetCurrentProfile(Name) | プロファイルを切り替える |
CreateProfile(Name) | 新しいプロファイルを作成し、そちらに切り替える |
RemoveProfile(Name) | プロファイルを削除する(現在のプロファイルは削除不可!) |
GetProfileParameter(Category, Name) | プロファイルの設定パラメーターを取得する |
SetProfileParameter(Category, Name, Value) | プロファイルの設定パラメーターを設定する |
GetCachedProfiles() | ローカルにキャッシュされたプロファイル名を取得する |
GetCurrentProfileName() | 現在のプロファイル名を取得する(キャッシュ済み) |
よく使うプロファイルパラメーター
| カテゴリ | パラメーター | 説明 |
|---|
Output | RecFilePath | 録画の保存先ディレクトリ |
Output | Mode | 出力モード(シンプル / 詳細) |
Stream | key | ストリームキー |
Stream | server | RTMP サーバー URL |
映像設定
| 関数 | 説明 |
|---|
GetVideoSettings() | 現在の解像度とフレームレートを取得する |
SetVideoSettings(Settings) | 複数の映像設定を一度に設定する |
SetBaseResolution(Width, Height) | キャンバスの解像度を設定する |
SetOutputResolution(Width, Height) | 出力(スケーリング後)の解像度を設定する |
SetFPS(Numerator, Denominator) | フレームレートを設定する |
GetCachedVideoSettings() | ローカルにキャッシュされた映像設定を取得する |
警告: 配信中または録画中は映像設定を変更できません!
よく使うフレームレート値
| FPS | 分子 | 分母 |
|---|
| 24 | 24 | 1 |
| 30 | 30 | 1 |
| 29.97 (NTSC) | 30000 | 1001 |
| 60 | 60 | 1 |
| 59.94 (NTSC) | 60000 | 1001 |
| 120 | 120 | 1 |
配信サービス設定
| 関数 | 説明 |
|---|
GetStreamServiceSettings() | 現在の配信先設定を取得する |
SetStreamServiceSettings(Settings) | 構造体を使って配信サービスを設定する |
SetSimpleRTMPSettings(Server, StreamKey) | カスタム RTMP の簡易セットアップ |
GetCachedStreamServiceSettings() | ローカルにキャッシュされた配信設定を取得する |
サービスの種類
| 種類 | 説明 |
|---|
rtmp_custom | カスタム RTMP サーバー(サーバー URL を自分で指定) |
rtmp_common | 設定済みのサービス(Twitch、YouTube など) |
よく使う RTMP サーバー
| サービス | サーバー URL |
|---|
| Twitch | rtmp://live.twitch.tv/app |
| YouTube | rtmp://a.rtmp.youtube.com/live2 |
| Facebook | rtmps://live-api-s.facebook.com:443/rtmp/ |
| Kick | rtmps://fa723fc1b171.global-contribute.live-video.net/app/ |
設定構造体(FOBSStreamServiceSettings)
| フィールド | 型 | 説明 |
|---|
StreamServiceType | FString | rtmp_custom または rtmp_common |
Server | FString | RTMP サーバー URL(rtmp_custom の場合) |
Key | FString | ストリームキー(機密情報!) |
Service | FString | サービス名(rtmp_common の場合。例:“Twitch”) |
bUseAuth | bool | 認証を使用するかどうか |
Username | FString | 認証ユーザー名 |
Password | FString | 認証パスワード |
注意事項:
- 変更を反映するには配信を再起動する必要があります。
- ストリームキーは機密データのため、安全に取り扱ってください。
- OBS はこれらの設定に関するイベントを送信しないため、手動で更新してください。
イベント
設定の変更に反応するには、以下のイベントを購読してください。
OnCurrentSceneCollectionChanging(SceneCollectionName): シーンコレクションの変更直前
OnCurrentSceneCollectionChanged(SceneCollectionName): シーンコレクションが変更された
OnSceneCollectionListChanged: シーンコレクション一覧が変更された
OnCurrentProfileChanging(ProfileName): プロファイルの変更直前
OnCurrentProfileChanged(ProfileName): プロファイルが変更された
OnProfileListChanged: プロファイル一覧が変更された
OnStreamServiceSettingsReceived(Settings): 配信サービス設定が取得された
関連項目