Unity 6.3
0 онлайн 2 гостей 3 в системе
Вход

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Обратный вызов, вызываемый при получении данных от удаленного сервера.