Описание
Предоставляет способы связи с веб-серверами.
UnityWebRequest обрабатывает поток связи HTTP с веб-серверами. Для загрузки и выгрузки данных используйте DownloadHandler и UploadHandler соответственно.
UnityWebRequest включает статические служебные функции, которые возвращают экземпляры UnityWebRequest, настроенные для распространенных случаев использования. Например:
Чтобы отправить веб-запрос из экземпляра UnityWebRequest, вызовите UnityWebRequest.SendWebRequest. После того как UnityWebRequest начнет обмениваться данными с удаленным сервером, вы не сможете изменить какие-либо свойства в экземпляре UnityWebRequest.< /p>
В зависимости от платформы, на которой работает ваше приложение, UnityWebRequest либо устанавливает Заголовок User-Agent сам или оставляет его на усмотрение операционной системы. UnityWebRequest устанавливает заголовок User-Agent для всех платформ, кроме iOS, платформ Xbox и WebGL.
Примечание. Начиная с Unity 2019.2, UnityWebRequest устанавливает заголовок User-Agent для устройств Android. . В более ранних выпусках операционная система устанавливала заголовок User-Agent.
Примечание. Если устройство, на котором запущено приложение, использует настройки прокси-сервера, UnityWebRequest применяет настройки прокси-сервера после того, как приложение отправит запрос.
Статические Свойства
| kHttpVerbCREATE | Строка «CREATE», обычно используемая в качестве глагола для HTTP-запроса CREATE. |
| kHttpVerbDELETE | Строка «DELETE», обычно используемая в качестве глагола для HTTP-запроса DELETE. |
| kHttpVerbGET | Строка «GET», обычно используемая в качестве глагола для HTTP-запроса GET. |
| kHttpVerbHEAD | Строка «HEAD», обычно используемая в качестве глагола для HTTP-запроса HEAD. |
| kHttpVerbPOST | Строка «POST», обычно используемая в качестве глагола для HTTP-запроса POST. |
| kHttpVerbPUT | Строка «PUT», обычно используемая в качестве глагола для HTTP-запроса PUT. |
Свойства
| certificateHandler | Содержит ссылку на объект CertificateHandler, который управляет проверкой сертификата для этого UnityWebRequest. |
| disposeCertificateHandlerOnDispose | Если значение равно true, любой CertificateHandler, присоединенный к этому UnityWebRequest, будет автоматически вызывать CertificateHandler.Dispose при вызове UnityWebRequest.Dispose. |
| disposeDownloadHandlerOnDispose | Если значение равно true, любой DownloadHandler, присоединенный к этому UnityWebRequest, будет автоматически вызывать DownloadHandler.Dispose при вызове UnityWebRequest.Dispose. |
| disposeUploadHandlerOnDispose | Если значение равно true, любой UploadHandler, присоединенный к этому UnityWebRequest, будет автоматически вызывать UploadHandler.Dispose при вызове UnityWebRequest.Dispose. |
| downloadedBytes | Возвращает количество байтов данных тела, которые система загрузила с удаленного сервера. (Только чтение) |
| downloadHandler | Содержит ссылку на объект DownloadHandler, который управляет данными тела, полученными с удаленного сервера этим UnityWebRequest. |
| downloadProgress | Возвращает значение с плавающей запятой от 0,0 до 1,0, указывающее ход загрузки данных тела с сервера. (Только чтение) |
| error | Удобочитаемая строка, описывающая любые системные ошибки, обнаруженные этим объектом UnityWebRequest при обработке HTTP-запросов или ответов. (Только чтение) |
| isDone | Возвращает true после завершения связи UnityWebRequest с удаленным сервером. (Только чтение) |
| isModifiable | Возвращает true, если свойства конфигурации UnityWebRequest могут быть изменены. (Только чтение) |
| method | Определяет глагол HTTP, используемый этим UnityWebRequest, например GET или POST. |
| redirectLimit | Указывает количество перенаправлений, которым будет следовать этот UnityWebRequest, прежде чем остановится с системной ошибкой «Redirect Limit Exceeded». |
| responseCode | Числовой код ответа HTTP, возвращаемый сервером, например 200, 404 или 500. (Только чтение) |
| result | Результат этого UnityWebRequest. |
| timeout | Устанавливает UnityWebRequest для попытки прерывания по истечении времени ожидания в секундах. |
| uploadedBytes | Возвращает количество байтов данных тела, которые система загрузила на удаленный сервер. (Только чтение) |
| uploadHandler | Содержит ссылку на объект UploadHandler, который управляет данными тела для загрузки на удаленный сервер. |
| uploadProgress | Возвращает значение с плавающей запятой от 0,0 до 1,0, указывающее ход загрузки данных тела на сервер. |
| uri | Определяет целевой URI для связи с UnityWebRequest. |
| url | Определяет целевой URL-адрес для связи с UnityWebRequest. |
| useHttpContinue | Определяет, будет ли этот UnityWebRequest включать Expect: 100-Continue в свои заголовки исходящих запросов. (По умолчанию: true). |
Конструкторы
| UnityWebRequest | Создает UnityWebRequest с параметрами по умолчанию и без прикрепленных DownloadHandler или UploadHandler. Метод по умолчанию — GET. |
Публичные Методы
| Abort | Если выполняется, останавливает UnityWebRequest как можно скорее. . |
| Dispose | Сигнализирует, что этот UnityWebRequest больше не используется и должен очистить все ресурсы, которые он использует. |
| GetRequestHeader | Извлекает значение пользовательского заголовка запроса. |
| GetResponseHeader | Извлекает значение заголовка ответа из последнего полученного ответа HTTP. |
| GetResponseHeaders | Извлекает словарь, содержащий все заголовки ответа, полученные этим UnityWebRequest в последнем ответе HTTP. |
| SendWebRequest | Начните общение с удаленным сервером. |
| SetRequestHeader | Задайте для заголовка HTTP-запроса пользовательское значение. |
Статические Методы
| ClearCookieCache | Очищает сохраненные файлы cookie из кеша. |
| Delete | Создает UnityWebRequest, настроенный для HTTP DELETE. |
| EscapeURL | Экранирует символы в строке, чтобы обеспечить их совместимость с URL. |
| GenerateBoundary | Создает случайный 40-байтовый массив для использования в качестве границы составной формы. |
| Get | Создает UnityWebRequest для HTTP GET. |
| Head | Создает UnityWebRequest, настроенный для отправки HTTP-запроса HEAD. |
| Post | Создает UnityWebRequest, настроенный для отправки данных формы на сервер через HTTP POST. |
| Put | Создает UnityWebRequest, настроенный для загрузки необработанных данных на удаленный сервер через HTTP PUT. |
| SerializeFormSections | Преобразует список объектов IMultipartFormSection в массив байтов, содержащий необработанные данные составной формы. |
| SerializeSimpleForm | Сериализация словаря строк в массив байтов, содержащий символы UTF8 в кодировке URL. . |
| UnEscapeURL | Преобразует удобные для URL escape-последовательности обратно в обычный текст. |
