DownloadHandlerFile
класс в UnityEngine.Networking
Наследуется от:Networking.DownloadHandler
Выполнено в:UnityEngine.UnityWebRequestModule
Описание
Обработчик загрузки для сохранения загруженных данных в файл.
Этот специализированный обработчик загрузки записывает все загруженные байт прямо в файл. Это может помочь избежать высокого использования памяти.
Вы не можете извлечь данные из этого обработчика загрузки. Вместо этого вы работаете с полученным файлом после завершения загрузки.
using System.Collections; using System.IO; using UnityEngine; using UnityEngine.Networking;
public class FileDownloader : MonoBehaviour {
void Start () { StartCoroutine(DownloadFile()); }
IEnumerator DownloadFile() { var uwr = new UnityWebRequest("https://unity3d.com/", UnityWebRequest.kHttpVerbGET); string path = Path.Combine(Application.persistentDataPath, "unity3d.html"); uwr.downloadHandler = new DownloadHandlerFile(path); yield return uwr.SendWebRequest(); if (uwr.result != UnityWebRequest.Result.Success) Debug.LogError(uwr.error); else Debug.Log("File successfully downloaded and saved to " + path); } }
Свойства
| Свойство | Описание |
|---|---|
| removeFileOnAbort | Должен ли созданный файл удаляться, если загрузка прерывается (вручную или из-за ошибки). По умолчанию: false. |
Конструкторы
| Конструктор | Описание |
|---|---|
| DownloadHandlerFile | Создает новый экземпляр и файл на диске, в который будут записаны загруженные данные. |
Унаследованные члены 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 | Обратный вызов, вызываемый при получении данных от удаленного сервера. |