DownloadHandlerBuffer
класс в UnityEngine.Networking
Наследуется от:Networking.DownloadHandler
Выполнено в:UnityEngine.UnityWebRequestModule
Описание
Реализация общего назначения DownloadHandler, которая хранит полученные данные в буфере байт.
Это подкласс общего назначения DownloadHandler. Он хранит полученные данные в собственной памяти. Он предварительно выделяет буфер данных на основе любого полученного заголовка Content-Length, но расширяет его буфер, если фактический размер загрузки превышает значение заголовка Content-Length (или если заголовок Content-Length не получен).
Примечание: При доступе к DownloadHandler.data или DownloadHandler.text в этом подклассе каждый раз при доступе к свойству выделяется новый массив байтов или строка.
using UnityEngine; using UnityEngine.Networking; using System.Collections;
public class MyBehaviour : MonoBehaviour { void Start() { StartCoroutine(GetText()); }
IEnumerator GetText() { UnityWebRequest www = new UnityWebRequest("https://www.my-server.com"); www.downloadHandler = new DownloadHandlerBuffer(); yield return www.SendWebRequest();
if (www.result != UnityWebRequest.Result.Success) { Debug.Log(www.error); } else { // Show results as text Debug.Log(www.downloadHandler.text);
// Or retrieve results as binary data byte[] results = www.downloadHandler.data; } } }
Конструкторы
| Конструктор | Описание |
|---|---|
| DownloadHandlerBuffer | Конструктор по умолчанию. |
Статические методы
| Метод | Описание |
|---|---|
| GetContent | Возвращает копию буфера основной памяти, интерпретированную как строка UTF8. |
Унаследованные члены 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 | Обратный вызов, вызываемый при получении данных от удаленного сервера. |