ウェブ リクエスト低レベル API リファレンス
低レベルのリクエストI を使用して、より上級者向けな HTTP 操作を実行します。
読み終わるまでの所要時間 10 分最終更新 5日前
高レベルのウェブリクエスト API は定型コードの必要性を最小限に抑えますが、低レベルのウェブリクエスト API は柔軟性とコントロールを提供します。
このセクションでは、低レベル API のキーメンバーと、それらが意図するシナリオを列挙します。一般に、低レベル API を使用するには、特定のダウンロードおよびアップロードのケース用に特殊なまたはオブジェクトをアタッチするを作成する必要があります。
DownloadHandlerUploadHandlerUnityWebRequest高レベル API と低レベル API は相互に排他的ではありません。一般的な操作をより細かくコントロールする必要がある場合は、高レベル API で作成された オブジェクトをいつでもカスタマイズできます。
UnityWebRequestUnityWebRequest オブジェクトのインスタンス化
UnityWebRequestUnityWebRequestUnityWebRequest詳細については、 API リファレンス を参照してください。
UnityWebRequestダウンロードハンドラー
専門的なダウンロードハンドラーを使用すると、特定のダウンロードケースを処理し、受信データの処理をコントロールできます。以下のダウンロードハンドラは、すべて基本クラス専用です。
DownloadHandlerハンドラータイプ | 説明 |
|---|---|
| シンプル データ ストレージに使用されます。このダウンロードハンドラーは最も簡単で、ほとんどのユースケースを処理します。受信したデータをネイティブ コード バッファに保存します。ダウンロードが完了すると、バイト配列またはテキスト文字列としてバッファされたデータにアクセスできます。 |
| 特殊なダウンロードハンドラー。大容量ファイルをダウンロードし、メモリ使用量を抑えながらディスクに保存します。ダウンロードされたバイトを直接ファイルに書き込むため、ダウンロードするファイルのサイズに関係なくメモリ使用量が少なくなります。他のダウンロードハンドラーとの違いは、ハンドラー自体からではなく、保存されたファイルからデータを取得することです。 |
| Unity テクスチャオブジェクトとして使用する画像をダウンロードするために最適化された特別なダウンロードハンドラー。これは、 |
| Unity アセットバンドルをダウンロードするために最適化された特別なダウンロードハンドラー。Unityのアセット システムに直接データをストリームし、結果として |
| オーディオファイルのダウンロード用に最適化された特別なダウンロードハンドラー。これは、 |
| カスタムのスクリプト可能な |
UnityWebRequestUnityWebRequest.disposeDownloadHandlerOnDisposeUnityWebRequest.DisposeDownloadHandler.DisposeUnityWebRequestdisposeDownloadHandlerOnDisposeアップロードハンドラー
アップロードハンドラーを使用すると、アップロードプロセスのさまざまな側面をより詳細にコントロールできます。以下のアップロードハンドラーは使用できます。これらはすべて基本クラス専用です。
UploadHandlerハンドラータイプ | 説明 |
|---|---|
| 構築時にデータ バッファを受け入れます。このバッファがバイト配列の場合、内部的にネイティブコードメモリにコピーされます。リモートサーバーがリクエストボディデータを受信する準備ができたとき、 |
| ファイルのコンテンツをリクエストボディとして送信できます。このハンドラーを使用すると、メモリーを多く使用せずに大きなファイルをサーバーに送信できます。ハンドラーは継続的にファイルからデータを読み取り、送信するため、メモリに保持されるのは常にファイルのほんの一部のみです。 |
UploadHandler.contentTypeContent-TypeUnityWebRequestUnityWebRequestContent-TypeContent-TypeUnityWebRequestUploadHandlerContent-Typeapplication/octet-stream``Content-TypeUnityWebRequestdisposeUploadHandlerOnDisposeUnityWebRequest.DisposeUploadHandler.DisposeUnityWebRequestdisposeUploadHandlerOnDispose