AudioPlayer
*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 jest używany do odtwarzania zasobów audio. Zapewnia pojedynczą przypinkę Wyjście , którą można połączyć z innymi przypinkami za pomocą Wires .
Przykłady kodu
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
Zasób, który ma zostać wczytany do AudioPlayer.
Kontroluje, czy Asset ładowanie automatycznie zostanie przypisane po przypisaniu.
Oznacza, czy to AudioPlayer jest obecnie odtwarzane.
Oznacza, czy ta AudioPlayer jest załadowana, buforowana i gotowa do grać.
Zakres, w sekundach, oznaczający początek i koniec pętla pożądanego w ciągu PlaybackRegion tej AudioPlayer .
Kontroluje, czy te pętle AudioPlayer się powtarzają.
Zakres w sekundach oznaczający żądaną godzinę startu (minimalną) i czas zatrzymania (maksymalny) w TimeLength .
Kontroluje, jak szybko zostanie odtworzony zasób, który kontroluje jego ton.
Oznacza długość załadowanego zasobu.
Śledzi obecną pozycję głowicy w obrębie zasobu.
Kontroluje głośność, z jaką zasób będzie odtwarzany.
Metody
Zwraca tablicę Wires, która jest połączona z określonym przypinać.
Odtwarza AudioPlayer z dowolnego miejsca, z którego pochodzi TimePosition.
Zatrzymuje AudioPlayer gdziekolwiek jest jego TimePosition .
Zdarzenia
Wypala się, gdy AudioPlayer zakończy odtwarzanie i zatrzyma się.
Wypala się, gdy pętle AudioPlayer się powtarzają.
Wystrzeliwuje, gdy inna instancja jest połączona z lub odłączona od AudioPlayer za pomocą Wire .
Właściwości
Asset
Zasób, który ma zostać wczytany do AudioPlayer.Jeśli AutoLoad jest true, zasób jest natychmiast wczytywany po przypisaniu tej właściwości.Gdy proces ładowania zostanie zakończony, IsReady staje się true .
AutoLoad
Kontroluje, czy Asset ładowane jest automatycznie po przypisaniu. Jeśli false, zasób zostanie załadowany przy pierwszej próbie grać.
IsPlaying
Oznacza, czy to AudioPlayer jest obecnie odtwarzane.Właściwość ta jest tylko do odczytu, ale replikuje się.Aby odtworzyć i zatrzymać AudioPlayer w czasie wykonania, użyj metod Play() i Stop().
IsReady
Oznacza, czy ta AudioPlayer jest załadowana, buforowana i gotowa do grać.Chociaż nie jest to powszechne, AudioPlayers może mieć zasoby rozładowane podczas uruchamiania, jeśli wystąpi ekstremalna presja pamięci, w której przypadek IsReady stanie się fałszywy.
LoopRegion
Zakres, w sekundach, oznaczający początek i koniec pętla pożądanego w ciągu PlaybackRegion tej AudioPlayer .
Jeśli minimalna wartość jest większa niż minimalna wartość , pętla zaczyna się od minimalnej wartości .
Jeśli minimalna wartość jest mniejsza niż minimalna wartość , pętla zaczyna się od minimalnej wartości .
Jeśli maksymalna wartość LoopRegion jest większa niż maksymalna wartość większa niż maksymalna wartość PlaybackRegion, pętla kończy się na wartości PlaybackRegion.
Jeśli maksymalna wartość jest mniejsza niż maksymalna wartość , pętla kończy się dokładnie na wartości .
Jeśli minimalny LoopRegion równa się maksymalnemu LoopRegion, właściwość AudioPlayer używa zamiast tego właściwości PlaybackRegion.
Looping
Kontroluje, czy te pętle AudioPlayer powtarzają się, gdy przekraczają koniec swojego TimeLength , LoopRegion lub PlaybackRegion .
PlaybackRegion
Zakres w sekundach oznaczający żądaną godzinę startu (minimalną) i czas zatrzymania (maksymalny) w TimeLength .
Jeśli minimalna wartość jest większa niż 0, dźwięk zaczyna się odtwarzać od minimalnego czasu .
Jeśli minimalny PlaybackRegion wynosi mniej niż 0, dźwięk zaczyna odtwarzać się od 0
Jeśli maksymalna wartość wynosi więcej niż , dźwięk kończy się na .
Jeśli maksymalna wartość PlaybackRegion wynosi mniej niż wartość TimeLength, dźwięk kończy się dokładnie na maksymalnej wartości PlaybackRegion.
Jeśli minimalny PlaybackRegion równa się maksymalnemu PlaybackRegion, dźwięk odtwarza się w całości.
PlaybackSpeed
Mnożnik kontroluje, jak szybko zostanie odtworzony zasób, bezpośrednio kontrolując jego postrzegany pitch. Zakres od 0 do 20.
Volume
Poziom głośności, który jest mnożony przez streamowaćwyjściowy audio, kontrolujący głośność odtwarzania zasobu. Zakres od 0 do 3.
Metody
GetConnectedWires
Zwraca tablicę Wires, która jest połączona z określonym przypinać. AudioPlayer ma jedną przypinać"Wyjście".
Parametry
Zwroty
Play
Odtwarza AudioPlayer z dowolnego miejsca, z którego pochodzi TimePosition. Replikuje się z serwera na klienta.
Zwroty
Stop
Zatrzymuje AudioPlayer gdziekolwiek jest jego TimePosition . Replikuje z serwera na klienta.
Zwroty
GetWaveformAsync
Parametry
Zwroty
Zdarzenia
Ended
Ogień po tym, jak AudioPlayer zakończył odtwarzanie i się zatrzymał.Zauważ, że to wydarzenie nie nie będzie strzelać do audio z Looped ustawionym na true, ponieważ nadal będzie odtwarzać po dotarciu do kończyć.To wydarzenie również nie wybuchnie, gdy dźwięk zostanie zatrzymany przed rozpoczęciem odtwarzania; do tego celu użyj AudioPlayer:GetPropertyChangedSignal() na właściwości IsPlaying.
To wydarzenie jest często używane do niszczenia AudioPlayer gdy skończy odtwarzanie.
Looped
Wydarzenie, które wystrzeliwuje po pętlach AudioPlayer .Dzieje się tak, gdy dźwięk dotrze do końca swojej treści (lub do końca LoopRegion jeśli jest aktywny) i Looping jest true .
To wydarzenie nie uruchamia nie ognia, jeśli dźwięk jest powielany ręcznie poprzez zmianę jego TimePosition.
WiringChanged
Wydarzenie, które wystrzeliwuje po tym, jak Wire łączy się lub odłącza się, a które Wire jest teraz połączone lub było wcześniej połączone z przypinką na AudioPlayer i z niektórymi innymi dostępnymi instancjami.
Parametry
Czy instancja została połączona czy odłączona.
Przypinka na AudioPlayer , która jest przeznaczona dla celów Wire.
The Wire pomiędzy AudioPlayer i inną instancja.