PygameでBGM・SEを自由自在に！mixer.Channel.stop()実践プログラミング例

2025-05-31

Pygameのミキサーモジュールでは、複数のサウンドを同時に再生するために「チャンネル」という概念を使用します。各チャンネルは独立しており、それぞれ異なるサウンドを再生したり、音量を調整したりすることができます。

mixer.Channel.stop()が呼び出されると、そのチャンネルで現在再生されているサウンドが即座に停止します。サウンドが停止した後、そのチャンネルは新しいサウンドを再生するために利用可能になります。

pygame.mixer.stop()との違い 混同しやすいものとして、pygame.mixer.stop()があります。これは、すべてのアクティブなミキサーチャンネルで再生中のサウンドを停止するグローバルな関数です。一方、mixer.Channel.stop()は、特定のチャンネルのサウンドのみを停止します。
mixer.Channel.stop()の役割 上記のように特定のChannelオブジェクトでサウンドを再生している場合、そのチャンネルのサウンドを止めたいときにchannel.stop()を使います。
```
# チャンネル0で再生中のサウンドを停止
channel.stop()
```
サウンドの再生方法 サウンドを再生するには、Soundオブジェクトのplay()メソッドを呼び出します。このとき、どのチャンネルで再生するかを指定しない場合、Pygameは自動的に利用可能なチャンネルを選んで再生します。明示的に特定のチャンネルで再生したい場合は、pygame.mixer.find_channel()などでチャンネルを取得し、そのChannelオブジェクトのplay()メソッドを使います。
```
import pygame

pygame.mixer.init()
sound_effect = pygame.mixer.Sound("explosion.wav")

# サウンドを再生すると、Pygameが自動的にチャンネルを割り当ててくれる
# この場合、どのチャンネルで再生されているか直接は分からない
# sound_effect.play()

# 特定のチャンネルで再生する場合
channel = pygame.mixer.Channel(0) # チャンネル0を取得
channel.play(sound_effect)
```
SoundオブジェクトとChannelオブジェクト pygame.mixer.Soundオブジェクトは、読み込まれたサウンドデータ（例えば、.wavファイルや.oggファイル）を表します。 pygame.mixer.Channelオブジェクトは、実際にサウンドを再生する「場所」または「スロット」を表します。
チャンネルとは？ Pygameのミキサーは、サウンドを再生するための「スピーカー」のようなものを複数持っていると考えるとわかりやすいです。これが「チャンネル」です。通常、Pygameはデフォルトで8つのチャンネルを提供しますが、必要に応じて数を変更できます。

よくあるエラーと問題点

pygame.error: mixer system not initialized
- 原因
  pygame.mixer.init() が呼び出される前に、ミキサー関連の機能（mixer.Sound()の作成、mixer.Channel()の操作など）を使用しようとした場合に発生します。
- 解決策
  Pygameのミキサー機能を使用する前に、必ずpygame.mixer.init()を呼び出してミキサーシステムを初期化してください。通常、プログラムの冒頭（pygame.init()の後）で行います。

```
import pygame

pygame.init() # Pygame全体を初期化
pygame.mixer.init() # ミキサーシステムを初期化

# ここからmixer.Channel.stop()などのミキサー機能が使える
```

原因
pygame.mixer.Soundオブジェクトに対して直接stop()メソッドを呼び出そうとした場合に発生します。stop()メソッドはpygame.mixer.Channelオブジェクトに属します。
解決策
mixer.Channel.stop()は、特定のチャンネルで再生中のサウンドを停止するものです。Soundオブジェクト自体を停止するのではなく、そのサウンドが再生されているChannelオブジェクトを取得してstop()を呼び出す必要があります。

import pygame

pygame.mixer.init()
sound_effect = pygame.mixer.Sound("explosion.wav")

# NG: sound_effect.stop()

# OK: チャンネルを取得して停止
channel = sound_effect.play() # play()は再生中のChannelオブジェクトを返す
# または、事前にチャンネルを作成して割り当てる
# channel = pygame.mixer.Channel(0)
# channel.play(sound_effect)

# しばらく待つ（例）
pygame.time.wait(1000)

channel.stop() # Channelオブジェクトのstop()を呼び出す

サウンドが停止しない（または期待通りに停止しない）
- 原因
  - stop()を呼び出しているChannelオブジェクトが、実際にサウンドを再生しているチャンネルと異なる。
  - サウンドが既に終了している。
  - サウンドがループ再生されており、stop()以外の方法で制御しようとしている（例：fadeout()を意図しているがstop()を使っている）。
- 解決策
  - どのチャンネルが再生しているか確認する
    sound.play()が返すChannelオブジェクトを保持し、そのオブジェクトに対してstop()を呼び出すのが最も確実です。
  - Channel.get_busy()で確認する
    channel.get_busy()を使って、そのチャンネルが現在サウンドを再生中かどうかを確認できます。Trueであれば再生中、Falseであれば停止しています。
  - ループ再生
    ループ再生（sound.play(loops=-1)など）しているサウンドを停止するには、やはりそのサウンドを再生しているチャンネルのstop()を呼び出す必要があります。
  - フェードアウト
    音を徐々に小さくしながら停止させたい場合は、channel.fadeout(milliseconds)を使用します。stop()は即座に停止します。
  - 同時に複数のサウンドを再生している場合
    それぞれのサウンドを異なるチャンネルで再生し、それぞれのチャンネルに対してstop()を呼び出すことで個別に制御できます。pygame.mixer.find_channel()やpygame.mixer.set_num_channels()を使ってチャンネル数を管理すると良いでしょう。
```
import pygame
import time

pygame.mixer.init()
sound1 = pygame.mixer.Sound("sound1.wav")
sound2 = pygame.mixer.Sound("sound2.wav")

# チャンネル数を増やす
pygame.mixer.set_num_channels(2)

# チャンネル0でsound1を再生
channel0 = pygame.mixer.Channel(0)
channel0.play(sound1)

# チャンネル1でsound2を再生
channel1 = pygame.mixer.Channel(1)
channel1.play(sound2)

time.sleep(2) # 2秒待つ

# チャンネル0のサウンドのみ停止
if channel0.get_busy():
    channel0.stop()
    print("チャンネル0のサウンドを停止しました。")
else:
    print("チャンネル0は再生中ではありません。")

time.sleep(1)

# チャンネル1のサウンドも停止
if channel1.get_busy():
    channel1.stop()
    print("チャンネル1のサウンドを停止しました。")
else:
    print("チャンネル1は再生中ではありません。")

pygame.quit()
```
サウンドファイルが見つからない/読み込めない
- 原因
  pygame.mixer.Sound("filename.wav") で指定したファイルが見つからない、または破損している場合。
- 解決策
  - ファイルパスが正しいか、ファイルが実際に存在するかを確認してください。
  - 相対パスを使用している場合は、スクリプトの実行ディレクトリを考慮してください。
  - サウンドファイルの形式がPygameでサポートされているか確認してください（WAV, OGG, MP3など）。ただし、MP3のサポートはプラットフォームやPygameのビルドによって異なる場合があります。

最小限の再現コードを作成する
問題が発生している部分だけを抜き出して、最小限のコードで再現できるか試します。これにより、問題が複雑なコード全体ではなく、特定の機能（mixer.Channel.stop()）に関連していることを確認できます。
printデバッグ
print()文を使って、変数の値（例: チャンネルオブジェクトがNoneになっていないか）、get_busy()の結果、コードの実行フローなどを確認することで、問題の箇所を特定しやすくなります。
エラーメッセージをよく読む
Pythonのエラートレースバックは、問題の原因を特定するための非常に重要な情報を含んでいます。どのファイル、どの行でエラーが発生しているかを確認しましょう。

例1: 基本的な停止

この例では、サウンドを再生し、短い時間待った後、そのサウンドを停止します。

import pygame
import time

# Pygameの初期化
pygame.init()

# ミキサーの初期化 (必ず行う)
# 周波数、バッファサイズなどを指定することもできます
pygame.mixer.init(frequency=44100, size=-16, channels=2, buffer=512)

# 画面のセットアップ（ミキサー機能とは直接関係ありませんが、Pygameアプリの一般的な構造）
screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Channel Stop Basic Example")

# サウンドファイルの読み込み
# ここでは、'sound_effect.wav'という名前のファイルがあると仮定します。
# 実際のファイルパスに置き換えてください。
try:
    sound_effect = pygame.mixer.Sound("sound_effect.wav")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    print("'sound_effect.wav'をスクリプトと同じディレクトリに配置してください。")
    pygame.quit()
    exit()

print("サウンドを再生します...")
# サウンドを再生し、再生に使われたチャンネルオブジェクトを取得
channel = sound_effect.play()

# サウンドが再生されていることを確認
if channel:
    print(f"サウンドはチャンネル {channel.get_num()} で再生中です。")
else:
    print("サウンドの再生に失敗しました（チャンネルが割り当てられなかった）。")
    pygame.quit()
    exit()

# 2秒間待つ
time.sleep(2)

# サウンドを停止
if channel.get_busy(): # チャンネルがまだ再生中か確認
    channel.stop()
    print("サウンドを停止しました。")
else:
    print("サウンドは既に停止していました。")

# アプリケーションを終了する前に少し待つ
time.sleep(1)

pygame.quit()
print("Pygameが終了しました。")

解説

channel.stop(): そのチャンネルで再生中のサウンドを即座に停止します。
channel.get_busy(): そのチャンネルが現在サウンドを再生中であるかどうかを返します（TrueまたはFalse）。stop()を呼び出す前に確認すると良いでしょう。
time.sleep(2): サウンドが再生されるのを待つためにプログラムの実行を一時停止します。
sound_effect.play(): サウンドを再生し、そのサウンドが再生されているChannelオブジェクトを返します。このChannelオブジェクトを保持しておくことが重要です。
pygame.mixer.Sound("sound_effect.wav"): 指定されたサウンドファイルを読み込み、Soundオブジェクトを作成します。
pygame.mixer.init(): ミキサーシステムを初期化します。サウンドを扱うには必須です。

例2: 複数のサウンドを個別に停止

この例では、複数のサウンドを異なるチャンネルで再生し、それぞれを個別に停止する方法を示します。

import pygame
import time

pygame.init()
pygame.mixer.init()

screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Multiple Channels Stop Example")

try:
    sound_a = pygame.mixer.Sound("sound_a.wav")
    sound_b = pygame.mixer.Sound("sound_b.wav")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    print("サウンドファイル 'sound_a.wav' と 'sound_b.wav' を配置してください。")
    pygame.quit()
    exit()

# チャンネル数を増やす（デフォルトは8）
pygame.mixer.set_num_channels(16) # 例として16チャンネルに設定

print("サウンドAを再生します...")
channel_a = pygame.mixer.find_channel(True) # 空いているチャンネルを探す
if channel_a:
    channel_a.play(sound_a, loops=-1) # sound_aをループ再生
    print(f"サウンドAはチャンネル {channel_a.get_num()} で再生中です。")
else:
    print("サウンドAの再生に利用可能なチャンネルがありません。")

time.sleep(1) # 少し待つ

print("サウンドBを再生します...")
channel_b = pygame.mixer.find_channel(True)
if channel_b:
    channel_b.play(sound_b) # sound_bを1回再生
    print(f"サウンドBはチャンネル {channel_b.get_num()} で再生中です。")
else:
    print("サウンドBの再生に利用可能なチャンネルがありません。")

time.sleep(3) # 3秒間待つ

# サウンドA（ループ再生中）を停止
if channel_a and channel_a.get_busy():
    channel_a.stop()
    print("サウンドAを停止しました。")
else:
    print("サウンドAは停止済みまたは再生中ではありませんでした。")

time.sleep(1) # 少し待つ

# サウンドB（おそらく再生終了済み）を確認
if channel_b and channel_b.get_busy():
    channel_b.stop()
    print("サウンドBを停止しました。")
else:
    print("サウンドBは停止済みまたは再生中ではありませんでした。")

time.sleep(1)

pygame.quit()

解説

channel_a.stop(): ループ再生中のサウンドAが停止されます。
sound_a.play(loops=-1): -1をloops引数に指定すると、サウンドが無限にループ再生されます。
pygame.mixer.find_channel(True): 現在空いているチャンネル（サウンドを再生中でないチャンネル）を見つけて返します。Trueを渡すと、見つからなかった場合にNoneを返します。
pygame.mixer.set_num_channels(16): 同時に再生できるチャンネルの最大数を設定します。多くのサウンドを同時に扱いたい場合に役立ちます。

実際のゲームでは、ユーザー入力やゲームの状態に応じてサウンドを停止することがよくあります。この例では、スペースキーが押されたらサウンドを停止します。

import pygame

# Pygameの初期化
pygame.init()
pygame.mixer.init()

screen_width = 800
screen_height = 600
screen = pygame.display.set_mode((screen_width, screen_height))
pygame.display.set_caption("Channel Stop with Event")

# サウンドの読み込み
try:
    background_music = pygame.mixer.Sound("background_music.ogg")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    print("'background_music.ogg'をスクリプトと同じディレクトリに配置してください。")
    pygame.quit()
    exit()

# BGMをループ再生するチャンネル
music_channel = pygame.mixer.Channel(0) # チャンネル0をBGM専用にする
music_channel.play(background_music, loops=-1) # 無限ループ

font = pygame.font.Font(None, 36)
text_surface = font.render("Press SPACE to stop music", True, (255, 255, 255))
text_rect = text_surface.get_rect(center=(screen_width // 2, screen_height // 2))

running = True
music_playing = True

while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
        if event.type == pygame.KEYDOWN:
            if event.key == pygame.K_SPACE:
                if music_playing:
                    if music_channel.get_busy():
                        music_channel.stop()
                        print("BGMを停止しました。")
                    music_playing = False
                else:
                    # 停止したBGMを再度再生することも可能
                    if not music_channel.get_busy():
                        music_channel.play(background_music, loops=-1)
                        print("BGMを再開しました。")
                    music_playing = True

    screen.fill((50, 50, 100)) # 背景色
    screen.blit(text_surface, text_rect)
    pygame.display.flip()

pygame.quit()

再開処理も含まれており、stop()で停止したチャンネルは、再度play()を呼び出すことでサウンドを再生できることを示しています。
if music_playing: と music_channel.stop(): music_playingフラグとget_busy()で、BGMが再生中であることを確認してからstop()を呼び出します。
event.type == pygame.KEYDOWN と event.key == pygame.K_SPACE: スペースキーが押されたイベントを検出します。
music_channel.play(background_music, loops=-1): BGMを無限ループで再生します。
music_channel = pygame.mixer.Channel(0): 特定のチャンネル（ここではチャンネル0）をBGM専用として確保しています。

pygame.mixer.fadeout(time) / channel.fadeout(time)

これはstop()の最も一般的な代替方法です。サウンドを即座に停止するのではなく、指定した時間（ミリ秒単位）をかけて徐々に音量を下げてから停止します。

使い方

import pygame
import time

pygame.init()
pygame.mixer.init()
screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Fadeout Example")

try:
    music = pygame.mixer.Sound("background_music.ogg")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    pygame.quit()
    exit()

channel = pygame.mixer.Channel(0)
channel.play(music, loops=-1) # BGMをループ再生

print("BGMを再生中... 3秒後にフェードアウトします。")
time.sleep(3)

# 2秒かけてBGMをフェードアウト
fade_time_ms = 2000
channel.fadeout(fade_time_ms)
print(f"{fade_time_ms / 1000}秒かけてBGMをフェードアウト中...")

# フェードアウトが完了するまで待つ
time.sleep(fade_time_ms / 1000 + 0.5) # フェードアウト時間 + 少し余裕

if not channel.get_busy():
    print("BGMが完全に停止しました。")

pygame.quit()

違い
stop()は即座に停止しますが、fadeout()は音量をゼロにするまで徐々に小さくします。
用途
BGMをスムーズに終了させたい場合、効果音を自然に消したい場合など。

channel.set_volume(value) を 0.0 に設定する

channel.set_volume()メソッドを使って、チャンネルの音量を0.0（無音）に設定することで、サウンドが再生され続けているものの、聞こえない状態にすることができます。これは厳密には「停止」ではありませんが、一時的にサウンドを聞こえなくしたい場合に有用です。

使い方

import pygame
import time

pygame.init()
pygame.mixer.init()
screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Set Volume to 0 Example")

try:
    alarm_sound = pygame.mixer.Sound("alarm.wav")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    pygame.quit()
    exit()

channel = alarm_sound.play(loops=-1) # アラーム音をループ再生

print("アラーム音を再生中... 3秒後にミュートします。")
time.sleep(3)

channel.set_volume(0.0) # 音量を0に設定
print("アラーム音をミュートしました（再生は継続中）。")

time.sleep(3)

channel.set_volume(1.0) # 音量を元に戻す（再開）
print("アラーム音のミュートを解除しました。")

time.sleep(3)

channel.stop() # 最後に完全に停止
print("アラーム音を停止しました。")

pygame.quit()

違い
サウンドの再生自体は継続されるため、CPUリソースは消費され続けます。また、stop()やfadeout()のようにチャンネルが解放されるわけではありません。
用途
一時的にサウンドをミュートしたい場合、後で音量を戻して再生を再開したい場合など。

pygame.mixer.stop()

これはmixer.Channel.stop()の「グローバル版」です。全てのアクティブなミキサーチャンネルで再生中のサウンドを即座に停止します。

使い方

import pygame
import time

pygame.init()
pygame.mixer.init()
screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Global Stop Example")

try:
    sound1 = pygame.mixer.Sound("sound1.wav")
    sound2 = pygame.mixer.Sound("sound2.wav")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    pygame.quit()
    exit()

pygame.mixer.set_num_channels(2) # 2チャンネルに設定

channel1 = pygame.mixer.Channel(0)
channel1.play(sound1, loops=-1)
print("チャンネル0でsound1を再生中...")

channel2 = pygame.mixer.Channel(1)
channel2.play(sound2, loops=-1)
print("チャンネル1でsound2を再生中...")

print("3秒後に全てのサウンドを停止します。")
time.sleep(3)

pygame.mixer.stop() # 全てのチャンネルのサウンドを停止
print("全てのサウンドを停止しました。")

time.sleep(1)

pygame.quit()

違い
channel.stop()が特定のチャンネルのみを対象とするのに対し、pygame.mixer.stop()はすべてのチャンネルを対象とします。
用途
ゲームを一時停止する際など、全てのサウンドを一度に止めたい場合。

これは直接「停止」するメソッドではありませんが、特定のチャンネルでサウンドが終了した後に、次のサウンドを自動的に再生する際に使えます。キューに入れられたサウンドは、現在のサウンドが終了すると自動的に再生されます。キューをクリアすることで、実質的に現在の再生を停止し、次のサウンドの再生を防ぐことができます。

使い方（キューのクリアによる制御）

import pygame
import time

pygame.init()
pygame.mixer.init()
screen = pygame.display.set_mode((600, 400))
pygame.display.set_caption("Queue Example")

try:
    intro_sound = pygame.mixer.Sound("intro.wav")
    loop_music = pygame.mixer.Sound("loop_music.ogg")
    end_sound = pygame.mixer.Sound("end.wav")
except pygame.error as e:
    print(f"サウンドファイルの読み込みに失敗しました: {e}")
    pygame.quit()
    exit()

channel = pygame.mixer.Channel(0)

# まずイントロサウンドを再生
channel.play(intro_sound)
print("イントロサウンドを再生中...")

# イントロサウンドが終わったらループミュージックをキューに入れる
channel.queue(loop_music)
print("ループミュージックをキューに入れました。")

# イントロサウンドの再生を待つ (仮に2秒)
time.sleep(2)

# 特定のイベントが発生したと仮定し、キューをクリアしてループミュージックの再生を防ぐ
# これにより、イントロサウンドが終了しても次のサウンドは再生されません。
channel.stop() # 現在のサウンド（イントロ）を停止
channel.queue(None) # キューをクリア (Noneをキューに入れることでキューを空にする)
print("キューをクリアし、現在のサウンドを停止しました。ループミュージックは再生されません。")

# もし、イントロサウンドが終了してからすぐにend_soundを再生したければ、
# channel.queue(end_sound) を直接呼び出すこともできます。

time.sleep(2)

pygame.quit()

channel.queue(None)は、キュー内のすべての要素をクリアします。これにより、キューに入れられていた次のサウンドは再生されなくなります。

違い
stop()は即座に停止しますが、キューの管理は次のサウンドの再生を制御するアプローチです。
用途
BGMの切り替え、効果音の連続再生など。

channel.queue(None): 次に再生される予定のサウンドをキャンセルしたい場合に、channel.stop()と組み合わせて使えます。
pygame.mixer.stop(): 全てのサウンドを一度に停止したい場合に便利です。
channel.set_volume(0.0): 一時的にサウンドをミュートし、後で簡単に再開したい場合に有用です。ただし、再生自体は続きます。
channel.fadeout(time): サウンドを自然に終了させたい場合に最適です。
channel.stop(): 最もシンプルで、即座にサウンドを停止する場合に最適です。

初心者必見！Pygameのmixer.Channel.get_soundを使ったサウンド制御プログラミング例

Pygameのサウンドシステムでは、音は「チャンネル」を通して再生されます。一度に複数の音を同時に再生できるように、複数のチャンネルが存在します。pygame. mixer. Soundオブジェクトは、実際に再生される音のデータ（WAVファイルなどから読み込まれたデータ）を表します。

【Pygame】mixer.Channel.get_volumeの全て：使い方からエラー対策まで

pygame. mixer. Channel. get_volume() は、Pygameのサウンドミキサーにおいて、特定のチャンネルの現在の音量を取得するために使用されるメソッドです。get_volume() メソッドは、引数を取らず、現在の音量を浮動小数点数（フロート）で返します。

ゲーム開発の音響制御：Pygame mixer.Channel.pause() の活用事例

「mixer. Channel. pause()」は、PygameのmixerモジュールにあるChannelオブジェクトのメソッドの一つで、そのチャンネルで再生中のサウンドを一時停止させるために使われます。具体的には、ある特定の効果音やBGMがチャンネルを通じて再生されている最中に、このメソッドを呼び出すと、そのサウンドの再生が中断されます。中断された時点の状態（再生位置など）は保持されるため、後で「mixer

【Pygame】mixer.Channel.playを使いこなす！実践的なコード例で学ぶサウンド制御

Pygameのサウンドシステム（pygame. mixerモジュール）は、複数のサウンドを同時に再生するために「チャンネル」という概念を使用します。デフォルトでは、Pygameは通常8つのチャンネルを提供し、サウンドを再生する際に自動的に空いているチャンネルが選択されます。

Pygameサウンド再生の落とし穴？mixer.Channel.queueのよくあるエラーと解決策

以下に詳しく説明します。Pygameのmixerモジュールは、複数のサウンドを同時に再生するために「チャンネル」という概念を使用します。各チャンネルは独立した音声再生の「スロット」のようなものです。Channelオブジェクトのqueue()メソッドは、そのチャンネルで現在再生中のサウンドが自然に終了した後に、指定された新しいサウンドを自動的に再生するように予約します。

Pygameサウンドプログラミング: set_endeventのよくあるエラーと解決策

以下に詳しく説明します。Pygameのサウンドシステムでは、同時に複数のサウンドを再生するために「チャンネル」という概念を使用します。pygame. mixer. Channelオブジェクトは、個々のサウンド再生を制御するためのものです。set_endevent() メソッドは、このチャンネルで再生されているサウンドが終了したときに、特定のイベントがPygameのイベントキューにポストされるように設定します。

Pygame mixer.Channel.set_volume徹底解説！音量調整の基本と応用

この関数を使うことで、個々のチャンネルから出力される音の大きさを調整できます。例えば、BGMのチャンネルと効果音のチャンネルで異なる音量に設定したり、特定の効果音だけ音量を大きくしたり小さくしたりといった制御が可能になります。引数volume: 設定したい音量を表す浮動小数点数（float）です。値の範囲は 0.0 から 1.0 までです。 0.0 は無音（聞こえない状態）を意味します。 1.0 は最大音量を意味します。 0.5 のように 0.0 と 1.0 の間の値を指定することで、中間の音量に設定できます。