AudioPlayer
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
AudioPlayer được sử dụng để chơi tài nguyên âm thanh. Nó cung cấp một đầu nối Output duy nhất có thể kết nối với các đầu nối khác thông qua Wires .
Mẫu mã
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()
Tóm Tắt
Thuộc Tính
Tài sản được tải vào AudioPlayer .
Kiểm soát xem có Asset tải tự động một khi được gán hay không.
Chỉ ra liệu điều này AudioPlayer hiện đang chơi hay không.
Chỉ ra liệu điều này AudioPlayer có được tải, bộ nhớ đệm và sẵn sàng chơi hay không.
Một phạm vi, trong giây lát, đại diện cho một vòng lặp mong muốn bắt đầu và kết thúc trong PlaybackRegion của vòng lặp này AudioPlayer .
Điều khiển xem liệu các vòng lặp này AudioPlayer có.
Phạm vi trong giây để đánh dấu thời gian bắt đầu mong muốn (tối thiểu) và thời gian dừng (tối đa) trong TimeLength .
Kiểm soát tốc độ mà tài sản sẽ được chơi, điều khiển cao độ của nó.
Chỉ thị chiều dài của tài sản được tải.
Theo dõi vị trí hiện tại của đầu phát trong tài sản.
Điều khiển mức độ lớn mà tài sản sẽ được phát.
Phương Pháp
Trả về một array của Wires được kết nối với ghimđược chỉ định.
Chơi AudioPlayer từ bất cứ nơi nào đó là TimePosition của nó.
Dừng lại AudioPlayer ở bất cứ nơi nào TimePosition của nó.
Sự Kiện
Bắt lửa khi AudioPlayer hoàn thành phát lại và dừng lại.
Bắt lửa khi các vòng AudioPlayer lặp.
Bắt lửa khi một instance khác được kết nối hoặc thoát kết nối với AudioPlayer thông qua một Wire .
Thuộc Tính
Asset
Tài sản được tải vào AudioPlayer .Nếu AutoLoad là true, tài sản sẽ tải ngay lập tức một khi thuộc tính này được gán.Khi tải hoàn thành, IsReady trở thành true .
AutoLoad
Kiểm soát xem có Asset tải tự động một khi được gán hay không. Nếu false, tài sản sẽ tải trong lần đầu tiên cố gắng chơi.
IsPlaying
Chỉ ra liệu điều này AudioPlayer hiện đang chơi hay không.Tính chất này chỉ đọc, nhưng sao chép.Để chơi và dừng một AudioPlayer tại thời gian chạy, hãy sử dụng các phương pháp Play() và Stop().
IsReady
Chỉ ra liệu điều này AudioPlayer có được tải, bộ nhớ đệm và sẵn sàng chơi hay không.Mặc dù không phổ biến, AudioPlayers có thể có tài sản của họ không được tải trong thời gian thực nếu có áp lực bộ nhớ cực đoan, trong trường hợp đó IsReady sẽ trở thành sai.
LoopRegion
Một phạm vi, trong giây lát, đại diện cho một vòng lặp mong muốn bắt đầu và kết thúc trong PlaybackRegion của vòng lặp này AudioPlayer .
Nếu giá trị tối thiểu của LoopRegion là lớn hơn giá trị tối thiểu của PlaybackRegion, vòng lặp bắt đầu từ giá trị tối thiểu của LoopRegion.
Nếu giá trị tối thiểu LoopRegion là ít hơn giá trị tối thiểu của PlaybackRegion, vòng lặp bắt đầu từ giá trị tối thiểu PlaybackRegion.
Nếu giá trị tối đa của LoopRegion là lớn hơn giá trị tối đa của PlaybackRegion, vòng lặp kết thúc tại giá trị tối đa của PlaybackRegion.
Nếu giá trị tối đa của LoopRegion là ít hơn hơn giá trị tối đa của PlaybackRegion, vòng lặp kết thúc tại chính xác giá trị tối đa của LoopRegion.
Nếu tối thiểu bằng tối đa, sử dụng đặc tính thay thế.
Looping
Kiểm soát xem liệu các vòng lặp này AudioPlayer khi vượt quá cuối của nó TimeLength , LoopRegion hoặc PlaybackRegion .
PlaybackRegion
Phạm vi trong giây để đánh dấu thời gian bắt đầu mong muốn (tối thiểu) và thời gian dừng (tối đa) trong TimeLength .
Nếu mức tối thiểu PlaybackRegion là lớn hơn 0, âm thanh bắt đầu phát từ thời gian PlaybackRegion tối thiểu.
Nếu mức tối thiểu PlaybackRegion là ít hơn 0, âm thanh bắt đầu phát từ 0.
Nếu giá trị tối đa của PlaybackRegion là lớn hơn của TimeLength, âm thanh sẽ dừng lại ở TimeLength .
Nếu giá trị tối đa của PlaybackRegion là ít hơn so với TimeLength, âm thanh dừng tại chính xác giá trị tối đa của PlaybackRegion.
Nếu tối thiểu bằng tối đa, âm thanh phát trong toàn bộ.
PlaybackSpeed
Nhân tỷ lệ kiểm soát tốc độ mà tài sản sẽ được chơi, trực tiếp kiểm soát cao độ nhận thấy của nó. Phạm vi từ 0 đến 20.
Volume
Cấp độ âm lượng được nhân với dòng âm phát trực tuyếnra, kiểm soát mức độ to của tài sản sẽ được phát. Phạm vi từ 0 đến 3.
Phương Pháp
GetConnectedWires
Trả về một array của Wires được kết nối với ghimđầu ra được chỉ định. AudioPlayer có một ghim"Output".
Tham Số
Lợi Nhuận
Play
Chơi AudioPlayer từ bất cứ nơi nào mà TimePosition của nó là. Bản sao lưu từ máy chủ sang khách hàng.
Lợi Nhuận
Stop
Dừng lại AudioPlayer ở bất cứ nơi nào mà TimePosition của nó là. Bản sao lưu từ máy chủ sang khách hàng.
Lợi Nhuận
GetWaveformAsync
Tham Số
Lợi Nhuận
Sự Kiện
Ended
Lửa bùng phát sau khi AudioPlayer hoàn thành phát lại và dừng lại.Lưu ý sự kiện này sẽ không bắt lửa cho âm thanh với Looped được đặt thành true kể từ khi nó tiếp tục chơi khi đạt đến kết thúc.Sự kiện này cũng sẽ không bắt lửa khi âm thanh bị dừng trước khi phát lại hoàn thành; để làm điều này, sử dụng AudioPlayer:GetPropertyChangedSignal() trên thuộc tính IsPlaying.
Sự kiện này thường được sử dụng để phá hủy một AudioPlayer khi nó đã hoàn thành phát lại.
Looped
Sự kiện bắt lửa sau các vòng lặp AudioPlayer .Điều này xảy ra khi âm thanh đạt đến cuối nội dung (hoặc cuối của LoopRegion nếu nó đang hoạt động) và Looping là true .
Sự kiện này không không bắn nếu âm thanh bị lặp bằng tay bằng cách thay đổi TimePosition của nó.
WiringChanged
Sự kiện xảy ra sau khi một Wire được kết nối hoặc mất kết nối, và sự kiện Wire bây giờ hoặc đã từng kết nối với một chốt trên AudioPlayer và một số ví ví dụ / trường hợpkhác có thể kết nối được.
Tham Số
Whether ví dụ đã kết nối hay mất kết nối.
Chốt trên AudioPlayer mà mục tiêu Wire nhắm.
Các Wire giữa AudioPlayer và ví dụ / trường hợpkhác.