跳到主要內容

URL 引數

您可以透過向 URL 新增引數來控制 Bilup 載入和執行專案的方式。這對於分享可復現的設定、嵌入具有特定選項的專案或自動化測試非常有用。

引數使用標準的查詢字串語法：URL 後加 ?，然後是 name=value 對，用 & 連線。純開關引數不取值：

https://com.bilup.org/123456789?turbo&fps=60&username=alice
備註

當您在編輯器中更改常用設定（渦輪模式、FPS、高質量畫筆、舞臺大小、插值）時，Bilup 會替您將它們儲存到 URL 中。下面的引數大多是您需要手動設定的"進階"引數，外加一些常用引數供參考。

載入專案​

引數值作用
(路徑)專案 IDcom.bilup.org/123456789 載入該專案
project_url直接 URL從任意啟用 CORS 的 URL 載入 .sb3（或 project.json）。不要與專案 ID 組合使用。
clonegit 倉庫 URL從 Bilup git 倉庫克隆專案（請參閱Git 整合）。

project_url 需要一個支援 CORS（Access-Control-Allow-Origin: *）的直接下載。省略協議時預設使用 https://；http:// URL 通常無法工作。GitHub Pages 非常適合此項。

https://com.bilup.org/?project_url=https://example.com/project.sb3

效能與執行時​

引數值作用
fps數字設定幀率。0 以顯示器重新整理率執行。
turbo開關啟用渦輪模式（不限制每幀節流）。
interpolate開關啟用插值以獲得更平滑的運動。
hqpen開關啟用高質量畫筆。
limitless開關移除雜項限制。
offscreen開關移除圍欄，讓角色可以離開舞臺。
clones數字設定最大克隆數（請參閱無限克隆）。
stuck開關啟用防卡死計時器。也接受 warp_timer。
nocompile開關停用編譯器。您幾乎永遠不會想用它。

顯示​

引數值作用
size寬度x高度設定自訂舞臺大小，例如 size=640x360。
scale數字限制舞臺允許放大的程度。scale=1 保持其原生解析度。
fullscreen-backgroundCSS 顏色全屏時顯示的背景顏色。將 # 轉義為 %23，例如 %23abc123。

帳戶與雲​

引數值作用
username字串設定 使用者名稱 積木返回的值，並用於雲端變數。以這種方式設定的使用者名稱不會儲存。
cloud_hostwss://... URL將雲端變數指向不同的伺服器。預設為 wss://clouddata.turbowarp.org。

協作​

引數值作用
room房間程式碼設定使用者名稱後自動加入即時協作房間。引數讀取後會被從 URL 中移除。

擴充功能​

引數值作用
extensionURL載入自訂擴充功能。可以重複以載入多個。
https://com.bilup.org/?extension=https://example.com/a.js&extension=https://example.com/b.js

這些擴充功能的用法請參閱建置擴充功能。

僅嵌入引數​

以下引數僅適用於嵌入播放器：

引數值作用
autoplay開關專案載入後自動點選綠旗。
addons逗號列表在嵌入中啟用特定外掛，例如 addons=pause,gamepad。
settings-button開關在嵌入中顯示進階設定按鈕。

另請參閱​