View source for In-Memory Audio Streaming (日本語)

このコードスニペットでは [[FileData (日本語)|FileData]] から音声を読み込んだ後に、メモリから音声を [[Decoder (日本語)|Decoder]] でデコードする基本的な方法について説明します。これは [[SoundData (日本語)|SoundData]] 全体をメモリに読み込むのとは異なり、ファイル全体をデコードするためメモリ消費量と処理時間が増加します。

LÖVE version [[0.10.2 (日本語)|0.10.2]] (Super Toast) および  [[11.0 (日本語)|11.0]] (Mysterious Mysteries) で動作します。また [[0.9.2 (日本語)|0.9.2]] (Baby Inspector) でも動作するかもしれません (要検証)。

== 簡易版 ==
動作原理を解説した非常に簡易的なスニペット。
<source lang="lua">
-- メモリへ音声ファイルデータを読み込みます
local audioFile = love.filesystem.newFileData("file/to/audio.ogg")
-- FileData から "stream" 方式の Source を新規作成します
local source = love.audio.newSource(audioFile, "stream")
-- "stream" 方式であることを保証します。この行は検査目的で使います
assert(source:getType() == "stream")
-- 音声を再生します
source:play()
</source>

== 完全版 ==
LÖVE フレームワークにおける実際の内部動作を解説に加えたスニペットです。
<source lang="lua">
-- 音声ファイルを開きます
local audioHandle = love.filesystem.newFile("file/to/audio.ogg", "r")
-- ファイルの内容を読み込みます。まだエンコード済み形式です。
local audioContents = audioHandle:read()
-- 音声の内容から FileData を新規作成します。
-- 正常なファイル拡張子が第二引数へ指定されていることを確認してください！ 
-- Decoder はデータの内容ではなく、拡張子から音声形式を判定します!
local audioData = love.filesystem.newFileData(audioContents, "_.ogg"))
-- 音声のデコードに使う Decorder を新規作成します
local decoder = love.sound.newDecoder(audioData)
-- 作成された Decoder から "stream" 方式の Source を新規作成します
local source = love.audio.newSource(decoder, "stream")
--  "stream" 方式であることを保証します。この行は検査目的で使います
assert(source:getType() == "stream")
-- 音声を再生します
source:play()
</source>

[[Category:Snippets (日本語)]]
[[Category:Tutorials (日本語)]]
{{#set:Author=User:AuahDark}}
{{#set:LOVE Version=[[0.10.0 (日本語)|0.10.0]]}}
{{#set:Description=メモリ内のデータを "stream" 方式で再生します。 RAM へエンコードした音声データを保存と[[Decoder (日本語)|デコード]]します。}}