`pyxen.Music`

Entityにコンポーネントとしてアタッチされるストリーミングオーディオトラックです。

Musicはオンデマンドでデコード（OGG Vorbis）されるため、BGMやアンビエンスなどの長いトラックに適しています。

オーディオのコンセプトについてはオーディオを参照してください。

コンストラクタ

Music(filename)

必須の位置引数が1つ：プロジェクト内のOGG Vorbisオーディオアセットの名前。

パラメータ	型	説明
`filename`	`str`	OGGアセットの名前

theme = Music("theme")

生成時：

bgm = world.spawn(music=Music("theme"))

または後から：

entity.music = Music("theme")

ミュージックを割り当てると即座に再生が開始されます。

entity.musicでアクセス：

プロパティ	型	R/W	説明
`loop`	`bool`	R/W	ループを有効にする
`volume`	`float`	R/W	ゲイン（0.0以上にクランプ）
`pan`	`float`	R/W	ステレオパンニング（-1.0〜1.0）
`time`	`float`	R	現在の再生位置（秒）
`duration`	`float`	R	全体の長さ（秒）
`finished`	`bool`	R	再生が完了するとTrue

entity.music.loop = True

有効にすると、トラックは終了後に自動的に再スタートします。BGMでは一般的です。

entity.music.volume = 0.5

0.0未満の値は0.0にクランプされます。

entity.music.pan = -1.0  # 完全に左
entity.music.pan =  1.0  # 完全に右
entity.music.pan =  0.0  # 中央

-1.0から1.0の範囲にクランプされます。

t = entity.music.time

読み取り専用。現在の再生位置（秒）。

d = entity.music.duration

読み取り専用。トラックの全体の長さ（秒）。

if entity.music.finished:
    world.destroy(entity)

読み取り専用。トラックの再生が完了するとTrue（loopがFalseの場合）。

ミュージックアセットはOGG Vorbisファイルでなければなりません。

Sound（WAV、完全にメモリに読み込み）と異なり、Musicはストリーミングされオンデマンドでデコードされます — 長いオーディオにより適しています。

Music()

ValueError: Music must have a file

Music("nonexistent")

ミュージックオブジェクトは作成されますが、再生は警告ログとともにサイレントに失敗します。