AudioPlayer

Hiển Thị Bản Đã Lỗi Thời

*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ã

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()

Tóm Tắt

Thuộc Tính

  • Asset:ContentId
    Đọc Song Song

    Tài sản được tải vào AudioPlayer .

  • Đọc Song Song

    Kiểm soát xem có Asset tải tự động một khi được gán hay không.

  • Bảo Mật Roblox
    Đọc Song Song

    Chỉ ra liệu điều này AudioPlayer hiện đang chơi hay không.

  • Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    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.

  • Đọc Song Song

    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 .

  • Đọc Song Song

    Điều khiển xem liệu các vòng lặp này AudioPlayer có.

  • Đọc Song Song

    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 .

  • Đọc Song Song

    Kiểm soát tốc độ mà tài sản sẽ được chơi, điều khiển cao độ của nó.

  • Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    Chỉ thị chiều dài của tài sản được tải.

  • Đọc Song Song

    Theo dõi vị trí hiện tại của đầu phát trong tài sản.

  • Đọc Song Song

    Điều khiển mức độ lớn mà tài sản sẽ được phát.

Phương Pháp

Sự Kiện

Thuộc Tính

Asset

ContentId
Đọc Song Song

Tài sản được tải vào AudioPlayer .Nếu AutoLoadtrue, 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

Đọc Song Song

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

Bảo Mật Roblox
Đọc Song Song

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()Stop().

IsReady

Chỉ Đọc
Không Sao Chép
Đọc Song Song

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

Đọc Song Song

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 LoopRegionlớ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í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 LoopRegionlớ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í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

Đọc Song Song

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

Đọc Song Song

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 PlaybackRegionlớ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ít hơn 0, âm thanh bắt đầu phát từ 0.

Nếu giá trị tối đa của PlaybackRegionlớn hơn của TimeLength, âm thanh sẽ dừng lại ở TimeLength .

Nếu giá trị tối đa của PlaybackRegioní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

Đọc Song Song

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.

TimeLength

Chỉ Đọc
Không Sao Chép
Đọc Song Song

Chỉ thị chiều dài của Asset được tải trong giây lát.

TimePosition

Đọc Song Song

Theo dõi và kiểm soát vị trí hiện tại của đầu phát trong Asset, trong vài giây.

Volume

Đọc Song Song

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

Instances

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ố

pin: string
Giá Trị Mặc Định: ""

Lợi Nhuận

Instances

GetInputPins


Lợi Nhuận

GetOutputPins


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

Sinh Lợi

Tham Số

timeRange: NumberRange
Giá Trị Mặc Định: ""
samples: number
Giá Trị Mặc Định: ""

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à Loopingtrue .

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ố

connected: boolean

Whether ví dụ đã kết nối hay mất kết nối.

pin: string

Chốt trên AudioPlayer mà mục tiêu Wire nhắm.

wire: Wire

Các Wire giữa AudioPlayer và ví dụ / trường hợpkhác.

instance: Instance

Các ví dụ khác được kết nối thông qua Wire .