Ren'Py は以下のフォーマットのファイルを使用したバックグラウンドでの音楽、効果音再生をサポートしています。
WAV (非圧縮 PCM のみ)
Ren'Py は任意の数のオーディオチャンネルをサポートしています。デフォルトでは 3 つのノーマルチャンネルが定義されています。 :
ノーマルチャンネルはオーディオの再生、キューに対応しますが、同時にひとつのオーディオファイルのみ再生します。新しいノーマルチャンネルは renpy.music.register_channel() で登録されます。
The 'Music Volume', 'Sound Volume', and 'Voice Volume' settings of the in-game preferences menu are used to set individual volumes for these channels.
ノーマルチャンネルに加えて、特別なチャンネル audio があります。この audio チャンネルは同時に複数のオーディオの再生をサポートしますが、サウンドのキューや再生の停止はサポートしません。
サウンドはボタンや選択肢、イメージマップがフォーカスを持つか押されると再生するようにも設定出来ます。 Button Style Properties を参照してください。 2 つの設定変数 config.main_menu_music と config.game_menu_music それぞれ指定されたオーディオファイルをメインメニューとゲームメインメニューで再生するように出来ます。
ゲーム中に、 Ren'Py で曲と効果音を再生する通常の方法は 3 つの music/sound ステートメントを使用することです。
The play statement is used to play sound and music. If a file is currently playing on a normal channel, it is interrupted and replaced with the new file.
The name of a channel is expected following keyword play,
(Usually, this is either "sound", "music", "voice", or "audio"). This is
followed by audiofile(s), where audiofile(s) can be one file or list of files.
When the list is given, the item of it is played in order.
The fadein and fadeout clauses are optional. Fadeout gives the fadeout
time for currently playing music, in seconds, while fadein gives the time
it takes to fade in the new music. If fadeout is not given, config.fade_music
is used.
The loop and noloop clauses are also optional. The loop clause causes
the music to loop, while noloop causes it to play only once. If both of them isn't
given, the default of the channel is used.
play music "mozart.ogg"
play sound "woof.mp3"
play myChannel "punch.wav" # 'myChannel' needs to be defined with renpy.music.register_channel().
"We can also play a list of sounds, or music."
play music [ "a.ogg", "b.ogg" ] fadeout 1.0 fadein 1.0
この auido チャンネルでは複数の play ステートメントで同時に複数のサウンドを再生します。
play audio "sfx1.opus"
play audio "sfx2.opus"
The stop statement begin with keyword stop, followed by the the name of a
channel to stop sound on. It may optionally have a fadeout
clause.
stop sound
stop music fadeout 1.0
The queue statement is used to queue up audio files. They will be played when the channel finishes playing the currently playing file.
The queue statement begin with keyword queue, followed by the the name of a
channel to play sound on. It optionally takes the loop and noloop clauses.
queue sound "woof.ogg"
queue music [ "a.ogg", "b.ogg" ]
The advantage of using these statements is that your program will be checked for missing sound and music files when lint is run. The functions below exist to allow access to allow music and sound to be controlled from python, and to expose advanced (rarely-used) features.
Ren'Py はオーディオファイルの部分的な再生をサポートします。このためにはファイルの始めの山括弧のなかで位置を指定します。部分再生指定は適切な名前と値のペアからなり、それぞれスペースで区切られます。
値はファイルの開始からの秒数と解釈されます。3つのプロパティー :
from最初に再生を開始するときの位置を指定します。 (デフォルトでは 0.0 秒)
to最初に再生を停止する位置を指定します。 (デフォルトでは 0.0 秒)
loop二回目からの再生開始位置を指定します。 (デフォルトでは from で指定された開始位置またはそのファイルの開始位置です。 )
例
play music "<from 5 to 15.5>waves.opus"
Will play 10.5 seconds of waves.opus, starting at the 5 second mark. The statement:
play music "<loop 6.333>song.opus"
Will play song.opus all the way through once, then loop back to the 6.333 second mark before playing it again all the way through to the end.
3.0 秒の無音が欲しい場合、 "<silence 3.0>" のような名前のファイル名を使用して、指定された時間無音を再生できます。これにより再生位置を遅延できます。 例
play audio [ "<silence .5>", "boom.opus" ]
0.5 秒の無音の後、爆発音を再生します。
play と queue ステートメントは audio ネームスペースでその引数を評価します。これにより define ステートメントでオーディオファイルにエイリアスを定義出来ます。
例えばこのように書くと
define audio.sunflower = "music/sun-flower-slow-jam.ogg"
このように使用します。
play music sunflower
renpy.play(filename, channel=None, **kwargs) link効果音を再生します。 channel が None なら、デフォルトで config.play_channel になります。これは hover_sound と activate_sound スタイルで定義されたサウンドを再生します。
renpy.seen_audio(filename) link指定したファイル名が 1 度でも現在のユーザーに再生されていれば True を返します。
renpy.music.get_duration(channel='music') linkchannel のオーディオやビデオの長さを返します。 ファイルが再生されていなければ 0.0 を返します。
renpy.music.get_pause(channel='music') linkchannel のポーズフラグを返します。
renpy.music.get_playing(channel='music') link指定されたチャンネルが再生中の場合、再生中のファイルの名前を返します。それ以外の場合は None を返します。
renpy.music.get_pos(channel='music') linkchannel のオーディオやビデオの現在位置を秒数で返します。ファイルが再生されていなければ None を返します。
チャンネルが再生前であったり、ミュートにされると None を返すため、この関数を呼び出すコードは常に None を処理するべきです。
renpy.music.is_playing(channel='music') link指定されたチャンネルが再生中なら True を返します。再生中でないかサウンドシステムが動作していないなら False を返します。
renpy.music.play(filenames, channel='music', loop=None, fadeout=None, synchro_start=False, fadein=0, tight=None, if_changed=False) linkこれは指定されたチャンネルで現在再生中の曲を停止し、キューされた曲をクリアし、指定されたファイルかファイルリストを再生開始します。
これは再生されるファイルかファイルのリストです。
サウンドを再生するチャンネル
これが True ならトラックはそれがキューの最後にある間ループを続けます。
None を指定するか、フェードアウトにかかる秒数を指定します。そうでなければフェードアウトの時間は config.fade_music から取られます。
Ren'Py では、synchro_start が True に設定されたチャンネルの間で、再生の開始を同時に行うことを保証できます。互いに同期させることを意図した2つのオーディオファイルを再生する場合、synchro_start を True に設定すべきです。
これは曲をフェードインするのにかかる秒数で、最初のループでのみ有効です。
True ならフェードアウトは次にキューされるサウンドにも適用されます。None なら loop が True のとき True になり、そうでなければ false です。
これが True でそのオーディオファイルが現在再生中なら、停止やフェードアウトも再び最初から再生もせずに再生を継続します。 ( これは常にそのオーディオファイルをキューに追加します。 )
channel のポーズフラグをクリアします。
renpy.music.queue(filenames, channel='music', loop=None, clear_queue=True, fadein=0, tight=None) link指定されたファイルを特定のチャンネルにキューします。
これは再生されるファイルかファイルのリストです。
サウンドを再生するチャンネル
これが True ならトラックはそれがキューの最後にある間ループを続けます。
True なら現在の再生が終了するとキューがクリアされると共にこれらのファイルが再生されます。 False ならこれらのファイルはキューの末尾に配置されます。どちらの場合でも音楽が再生されていなければこれらのファイルは即座に再生開始します。
これは曲をフェードインするのにかかる秒数で、最初のループでのみ有効です。
True ならフェードアウトは次にキューされるサウンドにも適用されます。None なら loop が True のとき True になり、そうでなければ false です。
channel のポーズフラグをクリアします。
renpy.music.register_channel(name, mixer=None, loop=None, stop_on_mute=True, tight=False, file_prefix='', file_suffix='', buffer_queue=True, movie=False) linkname と名付けられた新しいオーディオチャンネルを登録します。オーディオはチャンネルの名前を play または queue ステートメントに与えると、そのチャンネルで再生されます。
チャンネルが使用するミキサーの名前。デフォルトで Ren'Py には「 music 」,「 sfx 」,「 voice 」ミキサーが設定されています。他の名前の使用は可能ですが、設定画面の変更も必要かもしれません。
True の場合、このチャンネルのサウンドはデフォルトでループします。
True の場合、このチャンネルの曲はチャンネルがミュートになったら停止します。
True の場合、サウンドはフェードアウト中でもループします。これは、サウンドエフェクトやシームレスなミュージックチャンネルに対して True に、曲がそれ自身でフェードアウトする場合は False に設定すべきです。
このチャンネルで再生される曲のファイル名につけられる接頭辞。
このチャンネルで再生される曲のファイル名につけられる接尾辞。
キューに入れたファイルの最初の数秒をメモリに展開しますか？これはオーディオに対しては True 、ムービーに対しては False にすべきです。
True ならこのチャンネルはビデオ再生用に設定されます。
renpy.music.set_pan(pan, delay, channel='music') linkこのチャンネルのパンを設定します。
音源の位置を制御する -1 から 1 までの間の数字です。これが -1 だと全ての音は左側のチャンネルに送られ、 0 だと 2 つのチャンネルは等しくなります。 1 なら全ての音は右側に送られます。
パンの実行に掛ける時間です。
パンを実行するチャンネルです。これは sound または music チャンネルです。大抵これはチャンネル 7 で、デフォルトの music チャンネルです。
renpy.music.set_pause(value, channel='music') linkchannel のポーズフラグを value に設定します。 True なら、チャンネルはポーズし、そうでなければ通常どおり再生します。
renpy.music.set_queue_empty_callback(callback, channel='music') linkこれはキューが空になったときに呼び出されるコールバックを設定します。このコールバックはキューが最初に空になったときとキューが空になっている間のインタラクション毎に少なくとも 1 回呼び出されます。
コールバックは引数なしで呼び出されます。これは適切な引数で renpy.music.queue() を呼び出して曲をエンキュー出来ます。コールバックはキューが空である限り曲が再生されている間も呼び出されることに注意してください。
renpy.music.set_volume(volume, delay=0, channel='music') linkこのチャンネルの音量を、チャンネルを制御するミキサーの音量の割合で設定します。
これは 0.0 と 1.0 の間の数字で、そのチャンネルのミキサーボリュームの割合として解釈されます。
以前の値から新しい値に音量を変更するのに delay 秒掛かります。この値はセーブに保存され、ロールバックにも参加します。
設定されるチャンネルです。
renpy.music.stop(channel='music', fadeout=None) linkこれは現在再生中の曲を停止して、エンキューされた全ての曲をデキューします。 fadeout が None なら曲は config.fade_music で指定された時間でフェードアウトします。そうでなければ fadeout 秒でフェードアウトします。
これは最後にキューされたファイルを None に設定します。
再生を停止するチャンネル
None を指定するか、フェードアウトにかかる秒数を指定します。そうでなければフェードアウトの時間は config.fade_music から取られます。
Most renpy.music functions have aliases in renpy.sound. These functions are similar, except they default to the sound channel rather than the music channel, and default to not looping.