DownloadHandlerAudioClip
класс в UnityEngine.Networking
Наследуется от:Networking.DownloadHandler
Выполнено в:UnityEngine.UnityWebRequestAudioModule
Описание
Подкласс DownloadHandler, специализирующийся на загрузке аудиоданных для использования в качестве объектов AudioClip.
DownloadHandlerAudioClip хранит полученные данные в предварительно выделенной Unity AudioClip объект. Он оптимизирован для загрузки аудиоданных с веб-серверов и может выполнять распаковку и декодирование аудиоданных в рабочем потоке.
Для случаев использования, когда вы хотите загрузить аудиоклип через HTTP и использовать его в качестве AudioClip внутри Unity, настоятельно рекомендуется использовать именно этот класс.
using System.Collections; using UnityEngine; using UnityEngine.Networking;
public class AudioDownloader : MonoBehaviour {
void Start () { StartCoroutine(GetAudioClip()); }
IEnumerator GetAudioClip() { using (var uwr = UnityWebRequestMultimedia.GetAudioClip("https://myserver.com/mysound.ogg", AudioType.OGGVORBIS)) { yield return uwr.SendWebRequest(); if (uwr.result != UnityWebRequest.Result.Success) { Debug.LogError(uwr.error); yield break; }
AudioClip clip = DownloadHandlerAudioClip.GetContent(uwr); // use audio clip } } }
Свойства
| Свойство | Описание |
|---|---|
| audioClip | Возвращает загруженный AudioClip или null. (Только чтение) |
| compressed | Создать AudioClip, который сжат в memory.Note: Когда streamAudio является true, он заменяет сжатие, и обработчик загрузки создает AudioClip, похожий на импортированный клип с loadType и AudioClipLoadType.Streaming. |
| streamAudio | Создать поток AudioClip. |
Конструкторы
| Конструктор | Описание |
|---|---|
| DownloadHandlerAudioClip | Конструктор, определяет, какого рода аудио данные будут загружаться. |
Статические методы
| Метод | Описание |
|---|---|
| GetContent | Возвращает загруженный AudioClip или null. |
Унаследованные члены 3
Свойства
| Свойство | Описание |
|---|---|
| data | Возвращает необработанные байтовые данные, загруженные с удаленного сервера, или null. (только для чтения) |
| error | Сообщение об ошибке, описывающее сбой, который произошел внутри обработчика загрузки. |
| isDone | Возвращает true, если этот DownloadHandler был проинформирован родительским UnityWebRequest о том, что все данные были получены, и этот DownloadHandler завершил любую необходимую обработку после загрузки. (Только для чтения) |
| nativeData | Обеспечивает прямой доступ к загруженным данным. |
| text | Свойство удобства. Возвращает байт из данных, интерпретированных как строка UTF8. (Только чтение) |
Открытые методы
| Метод | Описание |
|---|---|
| Dispose | Сигнализирует, что DownloadHandler больше не используется и должен очистить все ресурсы, которые он использует. |
Защищенные методы
| Метод | Описание |
|---|---|
| CompleteContent | Обратный вызов, вызываемый, когда все данные были получены от удаленного сервера. |
| GetData | Обратный вызов, вызываемый при доступе к свойству данных. |
| GetNativeData | Обеспечивает свободный доступ к загруженным данным в качестве NativeArray. |
| GetProgress | Обратный вызов, вызываемый при доступе к UnityWebRequest.downloadProgress. |
| GetText | Обратный вызов, вызываемый при доступе к свойству text. |
| ReceiveContentLengthHeader | Получен обратный вызов, вызванный с заголовком Content-Length. |
| ReceiveData | Обратный вызов, вызываемый при получении данных от удаленного сервера. |