Udon can use external URLs to load remote content. URLs must be wrapped in a VRCUrl object. Users can enter URLs into VRCUrlInputField components at runtime, and world creators can provide pre-defined VRCUrls with their uploaded worlds.
Allowlist
For security reasons, VRChat restricts how external URLs can be used. By default, a VRCUrl can only be accessed if it is on VRChat's domain allowlist.
If a URL is not on the required allowlist for its type, it cannot be used unless the user chooses to "Allow Untrusted URLs" in VRChat's settings. This allows Udon to use load untrusted URL from VRCUrlInputField components and any VRCUrl that was uploaded alongside the world.
| On allowlist | Not on allowlist |
|---|
User enters VRCUrl into input field | ✔Allowed | ⚠ Requires "Allow Untrusted URLs" |
Udon declares the VRCUrl before runtime | ✔Allowed | ⚠ Requires "Allow Untrusted URLs" |
VRCUrl
class VRC.SDKBase.VRCUrl
Constructor
| Name | Summary |
|---|
| VRCUrl(string url) | Constructor that takes a URL as input. Note that this can only be called at editor time. |
Properties
| Static | Type | Name | Summary |
|---|
| ✔️ | VRCUrl | Empty | An empty URL. |
Methods
| Static | Returns | Name | Summary |
|---|
| string | Get() | Retrieves the current string value of the URL. |
| ✔️ | bool | IsNullOrEmpty(VRCUrl vrcUrl) | Indicates whether the specified VRCUrl is null or referencing an empty string (""). |