love.audio.newSource (Українська)

Створює новий об'єкт Source (джерело аудіо) на основі шляху до файлу, об'єкту File (англ.), Decoder (англ.) (файл) або SoundData (звукові дані). Джерела, створені на основі об'єктів SoundData (звукові дані), завжди статичні.

O.png Якщо викликати цю функцію багато разів (наприклад, з love.update чи love.draw), це може заповільнити роботу. Якщо якийсь ресурс вам потрібен часто, створіть його один раз і зберігайте для повторного використання!  



Функція

Доступне починаючи з LÖVE 11.0
Цей варіант недоступний в попередніх версіях.

Вигляд

source = love.audio.newSource( filename, type )

Аргументи

string filename
Шлях до аудіофайлу.
SourceType type
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Доступне починаючи з LÖVE 11.0
Цей варіант недоступний в попередніх версіях.

Вигляд

source = love.audio.newSource( file, type )

Аргументи

File file
Об'єкт File (файл), що вказує на аудіофайл.
SourceType type
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Доступне починаючи з LÖVE 11.0
Цей варіант недоступний в попередніх версіях.

Вигляд

source = love.audio.newSource( decoder, type )

Аргументи

Decoder decoder
Об'єкт Decoder (декодувальник), з якого буде створено джерело (об'єкт Source).
SourceType type
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Доступне починаючи з LÖVE 11.0
Цей варіант недоступний в попередніх версіях.

Вигляд

source = love.audio.newSource( data, type )

Аргументи

FileData data
Об'єкт FileData (файлові дані), з якого буде створено джерело (об'єкт Source).
SourceType type
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Вигляд

source = love.audio.newSource( data )

Аргументи

SoundData data
Об'єкт SoundData (звукові дані), з яких буде створено джерело (об'єкт Source).

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо. Для цього аудіо завжди буде повертатися SourceType (тип джерела) "static" (статичне).

Функція

Видалене в LÖVE 11.0
Цей варіант недоступний в LÖVE 11.0 і наступних версіях..

Вигляд

source = love.audio.newSource( filename, type )

Аргументи

string filename
Шлях до аудіофайлу.
SourceType type ("stream")
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Видалене в LÖVE 11.0
Цей варіант недоступний в LÖVE 11.0 і наступних версіях..

Вигляд

source = love.audio.newSource( file, type )

Аргументи

File file
Об'єкт File (файл), що вказує на аудіофайл.
SourceType type ("stream")
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Видалене в LÖVE 11.0
Цей варіант недоступний в LÖVE 11.0 і наступних версіях..

Вигляд

source = love.audio.newSource( decoder, type )

Аргументи

Decoder decoder
Об'єкт Decoder (декодувальник), з якого буде створено джерело (об'єкт Source).
SourceType type ("stream")
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Функція

Видалене в LÖVE 11.0
Цей варіант недоступний в LÖVE 11.0 і наступних версіях..

Вигляд

source = love.audio.newSource( data, type )

Аргументи

FileData data
Об'єкт FileData (файлові дані), з якого буде створено джерело (об'єкт Source).
SourceType type ("stream")
Тип джерела: потокове або статичне.

Повертає

Source source
Нове джерело аудіо (Source), яке може програвати вказане аудіо.

Зауваження

В версіях від 11.0 (англ.) до 11.2 (англ.) якщо в якості SourceType для цього конкретного конструктора передати queue, це не викличе помилку, а getType (англ.) поверне stream; для цього конкретного типу джерел потрібно використовувати love.audio.newQueueableSource. Цю помилку було виправлено в версії 11.3 (англ.).

Приклади

Завантажити і програти фонову музику

bgm = love.audio.newSource("bgm.ogg", "stream")
love.audio.play(bgm)

Завантажити і програти звуковий ефект

sfx = love.audio.newSource("sfx.wav", "static")
love.audio.play(sfx)

Завантажити звукові дані (SoundData) і створити джерело (Source)

data = love.sound.newSoundData("sfx.wav")
sfx = love.audio.newSource(data)

Завантажити декодувальник (Decoder) і створити джерело (Source)

decoder = love.sound.newDecoder("bgm.ogg")
bgm = love.audio.newSource(decoder, "stream")

Див. також


Іншими мовами