# オーディオバス設定用スクリプト

**URL:** https://guild.rpgmakerofficial.com/t/topic/1051
**Category:** 一般
**Created:** [2025 年 12 月 12 日午後 12:55 UTC](https://guild.rpgmakerofficial.com/t/topic/1051 "2025-12-12T12:55:28Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![Shirokishi](https://avatars.discourse-cdn.com/v4/letter/s/df788c/32.png) [@Shirokishi](https://guild.rpgmakerofficial.com/u/Shirokishi)
#### Post date: [2025 年 12 月 12 日午後 12:55 UTC](https://guild.rpgmakerofficial.com/t/topic/1051/1 "2025-12-12T12:55:28Z")

</div>

[サンプルオブジェクト.zip](https://guild.rpgmakerofficial.com/uploads/short-url/yeQbAIMsTwFOk92XsLP4cAjrilH.zip) (5.8 KB)  
[音量調節必須スクリプト.zip](https://guild.rpgmakerofficial.com/uploads/short-url/qYwOQpiESwv1x7xmC6UbgnB72HR.zip) (5.0 KB)  
[音量調節サンプルプロジェクト.zip](https://guild.rpgmakerofficial.com/uploads/short-url/A70a3hqQZRL2LwVZ6X7SLqGgeq1.zip) (222.6 KB)

# AudioBusControlButton 利用マニュアル

AudioBusControlButton は、押下時に AutoLoad の AudioBusSettings を呼び出し、指定した AudioServer のバスに対して、音量の段階切替、音量の増減、ミュート切替を行う Button です。  
保存は AudioBusSettings が `user://audio_settings.cfg` に行い、次回起動時に復元されます。

## 導入

1. AudioBusSettings のシーンを作成します

2. 作成したシーンを AutoLoad に登録します

3. AudioBusSettings の export 設定はシーン側で行います

4. AudioBusControlButton を配置します

## 最小構成

段階切替として使用する最小構成です。

1. `mode` を `CYCLE_LEVELS` に設定します
2. `cycle_levels_percent` は空のままにします  
空の場合は `AudioBusSettings.volume_levels` を使用します
3. 実行してボタンを押します  
音量が候補の次へ切り替わり、最後の次は先頭へ戻ります
4. 終了して再実行します  
保存が有効な場合、前回の設定が復元されます

## 設定の要点

`mode`

- `CYCLE_LEVELS` 現在値に最も近い候補を探し、その次の候補へ切り替えます
- `MUTE_TOGGLE` ミュートを反転します
- `VOLUME_UP` `step_percent_points` 分だけ線形音量を増やします
- `VOLUME_DOWN` `step_percent_points` 分だけ線形音量を減らします

`cycle_levels_percent`

- `CYCLE_LEVELS` 用の候補をパーセントで指定します
- 例 `0, 25, 50, 75, 100`
- 空の場合は `AudioBusSettings.volume_levels` を使用します

`step_percent_points`

- `VOLUME_UP` と `VOLUME_DOWN` の増減量です

表示

- `auto_label` が true の場合 `text` を自動更新します 固定したい場合は false にします
- `label_prefix` は先頭文字列です 空ならバス名が先頭になります