Version: 2017.1

WWW

class in UnityEngine

/

继承自:CustomYieldInstruction

切换到手册

描述

用于方便地访问网页。

这是一个用于检索 URL 内容的小型 utility 模块。

可以通过调用 WWW(url)(返回一个新的 WWW 对象)在后台启动下载。

您可以检查 isDone 属性以查看下载是否完成, 或通过 yield 方式自动等待下载对象(不阻塞游戏的其余部分)。

如果您需要从 Web 服务器获取一些数据来与游戏集成 (例如,实现分数排行榜或基于某种原因需要回传信息),则可以使用该类。此外,该类还有一些其他功能,例如: 使用从 Web 下载的图像创建纹理, 流式传输和加载新的 Web 播放器数据文件。

WWW 类可用于向服务器发送 GET 和 POST 请求。WWW 类默认使用 GET; 如果您提供了 postData 参数,则 WWW 类使用 POST。

另请参阅:WWWForm - 一种为 postData 参数构建有效表单数据的方法。

注意:传递给 WWW 类的 URL 必须经过“%”转义处理。

注意:在 iPhone 上,支持 http://,、https://file:// 协议。 ftp:// 协议支持仅限于匿名下载。不支持其他协议。

注意:在 Windows 和 Windows 应用商店应用程序中使用文件协议访问本地文件时,必须指定 file:///(带有三个斜杠)。

// Get the latest webcam shot from outside "Friday's" in Times Square
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public string url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg"; IEnumerator Start() { WWW www = new WWW(url); yield return www; Renderer renderer = GetComponent<Renderer>(); renderer.material.mainTexture = www.texture; } }

变量

assetBundle流式传输一个 AssetBundle,它可以包含项目文件夹中的任意类型的资源。
bytes以字节数组的形式返回获取的网页的内容(只读)。
bytesDownloaded该 WWW 查询下载的字节数(只读)。
error如果下载期间出错,则返回错误消息(只读)。
isDone是否完成下载?(只读)
progress下载进度(只读)。
responseHeaders请求返回的标头的字典。
text以字符串的形式返回获取的网页的内容(只读)。
texture返回从下载的数据生成的 Texture2D(只读)。
textureNonReadable返回从下载的数据生成的不可读的 Texture2D(只读)。
threadPriorityPriority of AssetBundle decompression thread.
uploadProgress上传进度(只读)。
url该 WWW 请求的 URL(只读)。

构造函数

WWW使用给定的 URL 创建一个 WWW 请求。

公共函数

Dispose释放现有的 WWW 对象。
GetAudioClip返回从下载的数据生成的 AudioClip(只读)。
GetAudioClipCompressed返回从下载的数据生成的 AudioClip(在内存中以压缩格式存储)(只读)。
LoadImageIntoTexture将一个现有的 Texture2D 的内容替换为来自下载数据的图像。

静态函数

EscapeURL对字符串中的字符进行转义以确保其支持 URL。
LoadFromCacheOrDownload从缓存中加载具有指定版本号的 AssetBundle。如果当前未缓存该 AssetBundle,则自动下载该 AssetBundle 并将其存储在缓存中,以便将来从本地存储检索。
UnEscapeURL将支持 URL 的转义序列转换回正常文本。

继承的成员

变量

keepWaiting指示协同程序是否应保持暂停。