ExportAudio(オーディオ制御)

VCIの中全体のオーディオを制御できます。
また_ALL_が付いている関数は空間内に居るユーザー全員のVCIで実行されます。

ExportAudioはVCI内に含まれるオブジェクト全体を参照してしまうので、オーディオの名前被りやインデックスが分からないといった場合があります。
現在はExportAudioは非推奨で、ExportAudioSourceの使用が推奨となりました。

ExportAssets. audio ExportAudio

VCI内のObjectを取得します。

サンプル

main.lua

local Audio = vci.assets.audio
function onUse(use)
    Audio._ALL_Play("Fire", 0.5, false)
end

実行結果

"Fire"というAudioを再生する。

• オーディオはオーディオクリップのファイル名で指定する方法と、AudioIndexで指定する方法があります。
• AudioIndexはhierarchyの上から順に登録されてゆきます。
• Index番号は0から始まります。
• 上記の画像ではAudioTest_1のアイテムの場合、index0を指定するとAudio1が再生され、
  AudioTest_2のアイテムの場合、index0を指定するとAudio5が再生されます。

ExportAudio.Play: fun(name: string, volumeScale: number, isLoop: bool)
ExportAudio._ALL_Play: fun(name: string, volumeScale: number, isLoop: bool)

第１引数：AudioClip名(String) 第２引数：音量(number) 第３引数：ループ設定(bool)

• 引数は全て入れる必要があります。省略できません。
• オーディオはAudioSourceのAudioClipに割り当てられたファイル名で指定します。
• 音量は0から1の間で指定し、1を超えた値で指定された場合は1として使います。

サンプル

main.lua

function onUse()
    -- trueならオーディオをループ再生、falseなら１回だけ再生
    local audioLoop = true
 
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    --"Audio1"をループ再生する
    vci.assets.audio._ALL_Play("Audio1", audioVolume, audioLoop)
end
 
function onUnuse()
    --"Audio1"オーディオを停止する
    vci.assets.audio._ALL_Stop("Audio1")
end

実行結果

(Useをした時に"Audio1"を音量0.5でループ再生します。)
(Unuseをした時に"Audio1"を停止します。)

PlayFromIndex: fun(index: number, volumeScale: number, isLoop: bool)
_ALL_PlayFromIndex: fun(index: number, volumeScale: number, isLoop: bool)

第１引数：インデックス番号(number) 第２引数：音量(number) 第３引数：ループ設定(bool)

• 引数は全て入れる必要があります。省略できません。
• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。
• 音量は0から1の間で指定し、1を超えた値で指定された場合は1として使います。

サンプル

main.lua

function onUse()
    -- trueならオーディオをループ再生、falseなら１回だけ再生
    local audioLoop = true
 
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    -- AudioIndex0 をループ再生する
    vci.assets.audio._ALL_PlayFromIndex(0, audioVolume, audioLoop)
end
 
function onUnuse()
    -- AudioIndex0 のオーディオを停止する
    vci.assets.audio._ALL_StopFromIndex(0)
end

実行結果

(Useをした時に AudioIndex0 を音量0.5でループ再生します。)
(Unuseをした時に AudioIndex0 を停止します。)

PlayOneShot: fun(name: string, volumeScale: number)
_ALL_PlayOneShot: fun(name: string, volumeScale: number)

第１引数：AudioClip名(String) 第２引数：音量(number)

• オーディオはAudioSourceのAudioClipに割り当てられたファイル名で指定します。
• 音量は0から1の間で指定し、1を超えた値で指定された場合は1として使います。

サンプル

main.lua

function onUse()
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    -- "Audio1" をループ再生する
    vci.assets.audio._ALL_PlayOneShot("Audio1", audioVolume)
end

実行結果

(Useをした時に"Audio1"を音量0.5で１回だけ再生します。)

PlayOneShotFromIndex: fun(index: number, volumeScale: number)
_ALL_PlayOneShotFromIndex: fun(index: number, volumeScale: number)

第１引数：インデックス番号(number) 第２引数：音量(number)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。
• 音量は0から1の間で指定し、1を超えた値で指定された場合は1として使います。

サンプル

main.lua

function onUse()
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    -- AudioIndex0 をループ再生する
    vci.assets.audio._ALL_PlayOneShotFromIndex(0, audioVolume)
end

実行結果

(Useをした時に AudioIndex0 を音量0.5で１回だけ再生します。)

Stop: fun(name: string)
_ALL_Stop: fun(name: string)

第１引数：AudioClip名(String)

• オーディオはAudioSourceのAudioClipに割り当てられたファイル名で指定します。

サンプル

main.lua

function onUse()
    --"Audio1"をループ再生する
    vci.assets.audio._ALL_Play("Audio1", 0.5, true)
end
 
function onUnuse()
    --"Audio1"オーディオを停止する
    vci.assets.audio._ALL_Stop("Audio1")
end

実行結果

(Useをした時に"Audio1"を音量0.5でループ再生します。)
(Unuseをした時に"Audio1"を停止します。)

StopFromIndex: fun(index: number)
_ALL_StopFromIndex: fun(index: number)

第１引数：インデックス番号(number)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。

サンプル

main.lua

function onUse()
    -- AudioIndex0 をループ再生する
    vci.assets.audio._ALL_PlayFromIndex(0, 0.5, true)
end
 
function onUnuse()
    -- AudioIndex0 のオーディオを停止する
    vci.assets.audio._ALL_StopFromIndex(0)
end

実行結果

(Useをした時に AudioIndex0 を音量0.5でループ再生します。)
(Unuseをした時に AudioIndex0 を停止します。)

Pause: fun(name: string, isPause: bool)
_ALL_Pause: fun(name: string, isPause: bool)

第１引数：AudioClip名(String) 第２引数：停止/再生の設定(bool)

• オーディオはAudioSourceのAudioClipに割り当てられたファイル名で指定します。
• trueの場合、オーディオの再生を一時停止します。
  falseの場合、一時停止しているオーディオの再生を再開します。

サンプル

main.lua

-- "Audio1" をループ再生する
vci.assets.audio._ALL_Play("Audio1", 0.5, true)
 
 
function onUse()
    -- "Audio1" の再生をポーズする
    vci.assets.audio._ALL_Pause("Audio1", true)
end
 
function onUnuse()
    -- "Audio1" のポーズを解除して再生を再開する
    vci.assets.audio._ALL_Pause("Audio1", false)
end

実行結果

(VCIを出した時に"Audio1"の再生がループ有で開始します。)
(Useをした時に"Audio1"を一時停止します。)
(Unuseをした時に"Audio1"を一時停止した時点から再生を行います。)

PauseFromIndex: fun(index: number, isPause: bool)
_ALL_PauseFromIndex: fun(index: number, isPause: bool)

第１引数：インデックス番号(number) 第２引数：停止/再生の設定(bool)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。
• trueの場合、オーディオの再生を一時停止します。
  falseの場合、一時停止しているオーディオの再生を再開します。

サンプル

main.lua

-- AudioIndex0 をループ再生する
vci.assets.audio._ALL_PlayFromIndex(0, 0.5, true)
 
 
function onUse()
    -- AudioIndex0 の再生をポーズする
    vci.assets.audio._ALL_PauseFromIndex(0, true)
end
 
function onUnuse()
    -- AudioIndex0 のポーズを解除して再生を再開する
    vci.assets.audio._ALL_PauseFromIndex(0, false)
end

実行結果

(VCIを出した時に AudioIndex0 の再生がループ有で開始します。)
(Useをした時に AudioIndex0 を一時停止します。)
(Unuseをした時に AudioIndex0 を一時停止した時点から再生を行います。)

IsPlaying: fun(name: string): bool

AudioClip名(String)

• オーディオはAudioClip名で指定します。

返り値

• 指定した音声の再生状況をbool型で返します。
  • 再生中の場合は `true` を返し、一時停止中あるいは停止中の場合 `false` を返します。

サンプル

main.lua

function onUse()
    -- "Audio1" の再生状況を取得する
    isPlaying = vci.assets.audio.IsPlaying("Audio1")
    print(isPlaying)
end

実行結果

false

main.lua

vci.assets.audio._ALL_Play("Audio1", 0.5, true)
 
function onUse()
    -- "Audio1" の再生状況を取得する
    isPlaying = vci.assets.audio.IsPlaying("Audio1")
    print(isPlaying)
end

実行結果

true

IsPlayingFromIndex: fun(index: number): bool

インデックス番号(number)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。

返り値

• 指定した音声の再生状況をbool型で返します。
  • 再生中の場合は `true` を返し、一時停止中あるいは停止中の場合 `false` を返します。

サンプル

main.lua

function onUse()
    -- AudioIndex0 の再生状況を取得する
    isPlaying = vci.assets.audio.IsPlayingFromIndex(0)
    print(isPlaying)
end

実行結果

false

main.lua

vci.assets.audio._ALL_PlayFromIndex(0, 0.5, true)
 
function onUse()
    -- AudioIndex0 の再生状況を取得する
    isPlaying = vci.assets.audio.IsPlayingFromIndex(0)
    print(isPlaying)
end

実行結果

true

GetDuration: fun(name: string): number

AudioClip名(String)

• オーディオはAudioClip名で指定します。

返り値

• 指定した音声ファイルの長さをnumber型で返します。
  • 単位は秒です。

サンプル

main.lua

function onUse()
    -- "Audio1" の長さを取得する
    local duration = vci.assets.audio.GetDuration("Audio1")
    print(duration)
end

実行結果

10.5

GetDurationFromIndex: fun(index: number): number

インデックス番号(number)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。

返り値

• 指定した音声ファイルの長さをnumber型で返します。
  • 単位は秒です。

サンプル

main.lua

function onUse()
    -- AudioIndex0 のオーディオの長さを取得する
    local duration = vci.assets.audio.GetDurationFromIndex(0)
    print(duration)
end

実行結果

10.5

GetCurrentTime: fun(name: string): number

AudioClip名(String)

• オーディオはAudioClip名で指定します。

返り値

• 指定した音声ファイルの現在の再生位置を返します。
  • 単位は秒です。

サンプル

main.lua

function onGrab()
    -- trueならオーディオをループ再生、falseなら１回だけ再生
    local audioLoop = true 
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    -- AudioIndex0 をループ再生する
    print("StartPlaying Audio")
    vci.assets.audio.PlayFromIndex(0, audioVolume, audioLoop)
end
 
function onUse()
    local currentTime = vci.assets.audio.GetCurrentTime("Audio1")
    print("currentTime: "..tostring(currentTime))
end

実行結果（Grabした後にUseした際の出力）

currentTime: 1.523

GetCurrentTimeFromIndex: fun(index: number): number

インデックス番号(number)

• オーディオはAudioIndexのnumberで指定します。
  Indexの割り当てルールは こちらを確認してください。

返り値

• 指定した音声ファイルの現在の再生位置を返します。
  • 単位は秒です。

サンプル

main.lua

function onGrab()
    -- trueならオーディオをループ再生、falseなら１回だけ再生
    local audioLoop = true 
    -- 0 から 1 の間で音量を指定
    local audioVolume = 0.5
 
    -- AudioIndex0 をループ再生する
    print("StartPlaying Audio")
    vci.assets.audio.PlayFromIndex(0, audioVolume, audioLoop)
end
 
function onUse()
    local currentTime = vci.assets.audio.GetCurrentTimeFromIndex(0)
    print("currentTime: "..tostring(currentTime))
end

実行結果（Grabした後にUseした際の出力）

currentTime: 1.523