AudioPlayer

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

AudioPlayer służy do odtwarzania zasobów audio. Dostarcza jeden Output pin, który można połączyć z innymi wtyczkami za pośrednictwem Wires.

Przykłady kodu

Outputting Audio to Device

local audioPlayer : AudioPlayer = Instance.new("AudioPlayer")
audioPlayer.Parent = workspace
audioPlayer.AssetId = "rbxassetid://9112854440"
local deviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local wire = Instance.new("Wire")
wire.Parent = workspace
wire.SourceInstance = audioPlayer
wire.TargetInstance = deviceOutput
audioPlayer:Play()

Podsumowanie

Właściwości

Metody

Właściwości

AssetId

Odczyt równoległy

Zasób do załadowania w AudioPlayer. Jeśli AutoLoad jest prawdziwy, zasób zostanie natychmiastowo załadowany po przydzieleniu tej właściwości. Gdy ładowanie jest zakończone, IsReady staje się prawdziwy.

AutoLoad

Odczyt równoległy

Kontroluje czy AssetId zostanie automatycznie załadowany po przydzieleniu. Jeśli fałszywy, zasoby zostaną załadowane po pierwszej próbie grać.

IsPlaying

Zabezpieczenia na platformie Roblox
Odczyt równoległy

Oznacza, czy ten AudioPlayer gra teraz. Ta właściwość jest tylko czytelna, ale replikuje. Aby odtwarzać i zatrzymywać AudioPlayer podczas uruchomienia, użyj metod Class.AudioPlayer:Play()|Play() i 2>Class.AudioPlayer:Stop()|Stop() .

IsReady

Tylko do odczytu
Bez replikacji
Odczyt równoległy

Określa, czy ten AudioPlayer jest załadowany, zatrzymany i gotowy do grać. Mimo że nie jest to powszechne, AudioPlayers może mieć swoje zasoby niezaładowane podczas uruchomienia, w przypadku gdy jest skrajne ciśnienie pamięci, w takim przypadku IsReady stanie się fałszywy.

LoopRegion

Odczyt równoległy

Zakres, w sekundach, określający początek i końc w pętli w PlaybackRegion tego AudioPlayer .

Jeśli LoopRegion minimalny jest większy niż minimum PlaybackRegion, to pętla zaczyna się od minimum 1> Class.AudioPlayer.LoopRegion1>.

Jeśli LoopRegion minimalny jest mniej niż minimalny PlaybackRegion, to pętla zaczyna się od minimum 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1>.

Jeśli maksymalna liczba LoopRegion wynosi większą niż maksymalna liczba PlaybackRegion, to końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy końcowy koń

Jeśli maksymalna liczba LoopRegion wynosi Class.AudioPlayer.PlaybackRegion|PlaybackRegion maksymalnie, to końcowy zapis PlaybackRegion kończy się dokładnie na 2>Class.AudioPlayer.LoopRegion|LoopRegion2> maksymalnie.

Jeśli LoopRegion minimum jeśli jest LoopRegion Class.AudioPlayer.LoopRegion>, 1> Class.AudioPlayer1> używa w zamian właściwości 4> Class.AudioPlayer.PlaybackRegion|PlaybackRegion4>.

Looping

Odczyt równoległy

Kontroluje, czy ten AudioPlayer 루프, gdy przekroczy końc TimeLength , LoopRegion lub 2>Class.AudioPlayer.PlaybackRegion|PlaybackRegion2>.

PlaybackRegion

Odczyt równoległy

Zakres w sekundach określający pożądany czas startu (minimum) i czas zatrzymania (maksimum) w TimeLength .

Jeśli PlaybackRegion minimalny jest większy niż 0, dźwięk zaczyna się odtwarzać z PlaybackRegion minimalnego czasu.

Jeśli PlaybackRegion minimalny jest mniej niż 0, dźwięk zaczyna się od 0.

Jeśli maksymalna liczba PlaybackRegion wynosi Class.AudioPlayer.TimeLength|TimeLength lub większa, dźwięk zatrzymuje się na TimeLength.

Jeśli PlaybackRegion maksymalny jest mniej niż TimeLength, dźwięk kończy się dokładnie na 2>Class.AudioPlayer.PlaybackRegion|PlaybackRegion2> maksymalnie.

Jeśli PlaybackRegion minimum uje maksymalną PlaybackRegion dźwięk w całości.

PlaybackSpeed

Odczyt równoległy

Mnożnik kontrolujący, jak szybko zostanie odtwarzany utwór, bezpośrednio kontrolujący jego postrzegany odcień. Zakres od 0 do 20.

TimeLength

Tylko do odczytu
Bez replikacji
Odczyt równoległy

Oznacza długość załadowanego AssetId w sekundach.

TimePosition

Odczyt równoległy

Śledzi i kontroluje bieżącą pozycję głowicy w AssetId, w sekundach.

Volume

Odczyt równoległy

Volume poziom, który jest mnożony na streamowaćaudio wyjści, kontrolując jak głośno zostanie odtwarzane zasoby. Zakres od 0 do 3.

Metody

GetConnectedWires

Instances

Zwraca Wires, które są połączone z określonym przypinać. AudioPlayer ma jeden przypinać"Wyjście".

Parametry

pin: string

Zwroty

Instances

Play

void

Odtwarza AudioPlayer z dowolnego miejsca, w którym znajduje się TimePosition . Replikuje z serwera do klienta.


Zwroty

void

Stop

void

Zatrzymuje AudioPlayer gdziekolwiek jego TimePosition jest. Replikuje z serwera do klienta.


Zwroty

void

GetWaveformAsync

Wynik

Parametry

timeRange: NumberRange
samples: number

Zwroty

Zdarzenia

Ended

Wystąpi po tym, jak AudioPlayer zakończył odtwarzanie i zatrzymał. Uwaga, że to wydarzenie nie będzie odtwarzać się, jeśli audio ma Class.Audio

Ten wątek jest często używany do usuwania AudioPlayer gdy zakończy się odtwarzanie.


Looped

Wydarzenie, które się wykonuje po pętli AudioPlayer. Dzieje się to, gdy dźwięk osiąga końca swojego treści (lub końca LoopRegion jeśli jest aktywny) i Looping jest 1> 真1> .

Ten wąż nie ognia, jeśli dźwięk jest łączony ręcznie poprzez zmianę jego Class.AudioPlayer.TimePosition|TimePosition.