Skip to main content

Audio

This object represents an audio file to be treated as music by the Bale clients.

📝 Schema

FieldTypeDescription
file_idStringIdentifier for this file, which can be used to download or reuse the file
file_unique_idStringUnique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
durationIntegerDuration of the audio in seconds as defined by the sender
titleStringOptional. Title of the audio as defined by the sender or by audio tags
file_nameStringOptional. Original filename as defined by the sender
mime_typeStringOptional. MIME type of the file as defined by the sender
file_sizeIntegerOptional. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.

⚙️ Get methods

getFileId()

Retrieves the identifier for this file, which can be used to download or reuse the file.

$audioFileId = $audioObject->getFileId();

getFileUniqueId()

Retrieves the unique identifier for this file, which remains constant over time and across different bots.

$audioFileUniqueId = $audioObject->getFileUniqueId();

getDuration()

Retrieves the duration of the audio in seconds as defined by the sender.

$audioDuration = $audioObject->getDuration();

getTitle()

Retrieves the title of the audio, if available.

$audioTitle = $audioObject->getTitle();

getFileName()

Retrieves the original filename of the audio, if available.

$audioFileName = $audioObject->getFileName();

getMimeType()

Retrieves the MIME type of the audio file, if available.

$audioMimeType = $audioObject->getMimeType();

getFileSize()

Retrieves the file size of the audio in bytes, if available.

$audioFileSize = $audioObject->getFileSize();

➕ More

tip

For further information, refer to the official Bale documentation for more details.