跳至主要内容

modelAPI / modelDir 怎麼填

WordPress 後台 → Live2D 設定 → 「創意工坊 API 類型」選 自訂 後會出現兩個輸入欄：

  • modelAPI — 一個 URL 或 URL 前綴
  • modelDir — 一個列表，每行一個子目錄名

它們的組合方式由 modelAPI 的 結尾字元 決定，只有兩種填法。

填法 ①：直連單模型（modelAPI 以 .json 結尾）​

modelAPI 直接填一個完整的 *.model3.json URL，下方 modelDir 列表會被 忽略。

範例

modelAPI:  https://cdn.example.com/live2d/haru/haru.model3.json
modelDir:  （留空，會被忽略）

載入時瀏覽器直接請求這個 JSON。前台的「上一個 / 下一個」切換按鈕在這種模式下沒有意義，建議在後台關閉。

填法 ②：目錄根 + 多模型（modelAPI 以 / 結尾）​

modelAPI 是一個根目錄 URL，modelDir 列出多個子目錄名。外掛按 {modelAPI}{名稱}/{名稱}.model3.json 自動拼接成完整 URL。

關鍵限制：每個子目錄裡的 *.model3.json 檔名必須與子目錄名完全一致。

範例

modelAPI:  https://cdn.example.com/live2d/

modelDir:
  - haru
  - mao
  - shizuku

實際載入時外掛會拼成：

https://cdn.example.com/live2d/haru/haru.model3.json
https://cdn.example.com/live2d/mao/mao.model3.json
https://cdn.example.com/live2d/shizuku/shizuku.model3.json

前台的「眨眼按鈕 / 切換按鈕」會在這幾個模型之間循環。

選哪一種？​

場景推薦填法
只掛一個固定模型，不打算切換① 直連
想讓訪客能在多個模型之間切換② 目錄根 + 多個 modelDir
想用「託管到本站」託管模型② —— 此時 modelAPI 輸入欄被隱藏，只填 modelDir

路徑 / 通訊協定要求​

  • 路徑裡 不能有非 ASCII / 中文字元。
  • 站點是 https，那麼 modelAPI 以及它引用到的所有檔案（.moc3、貼圖、motion3.json、physics3.json、cdi3.json 等）都必須是 https，否則瀏覽器會因混合內容而錯誤。
  • 跨域：把模型放到 OSS / COS / 自家 CDN 時，請正確開啟 CORS（一般加上你的網站網域作為允許的 Origin 即可）。

瀏覽器擴充功能端有什麼不同？​

瀏覽器擴充功能的「自訂 URL（付費）」模式 modelAPI / modelDir 填法與 WordPress 外掛完全一致，只是沒有「託管到本站」選項。請確保你的來源 URL 允許 chrome-extension://... 或 * 作為 Origin。