Extension SDK

ส่วนขยายของ drawtonomy เป็นเว็บแอปที่ host ใน iframe และ สื่อสารกับโปรแกรมแก้ไขผ่าน postMessage SDK ให้ไคลเอนต์ แบบ typed dev-server ให้โปรแกรมแก้ไขในเครื่องเพื่อพัฒนา

หน้านี้คือการแนะนำอย่างรวดเร็ว คู่มือเต็ม — schema ของ manifest รายการ capabilities โปรโตคอลข้อความ — อยู่ในรีโป public:

➡ Extension Development Guide (日本語)

เริ่มต้นอย่างรวดเร็ว

# โปรแกรมแก้ไขที่ :3000
pnpm add -g @drawtonomy/dev-server
drawtonomy-dev-server

# ส่วนขยายของคุณที่ :3001
cd my-extension && pnpm dev --port 3001

open "http://localhost:3000/?ext=http://localhost:3001/manifest.json"

ส่วนขยายขั้นต่ำ

my-extension/
  manifest.json
  index.html
  src/

manifest.json

{
  "id": "my-extension",
  "name": "My Extension",
  "version": "1.0.0",
  "entry": "./index.html",
  "capabilities": ["shapes:read", "shapes:write", "ui:panel"]
}

src/main.ts

import { ExtensionClient, createVehicle } from '@drawtonomy/sdk'

const client = new ExtensionClient()
await client.ready()

document.getElementById('add')!.addEventListener('click', async () => {
  await client.addShapes([createVehicle(0, 0, { templateId: 'sedan' })])
})

ส่วนขยายอ้างอิง

ส่วนขยายในตัวเป็นตัวอย่างเต็มรูปแบบ:

• ai-scene-generator — การสร้างฉากจากภาษาธรรมชาติและ OpenSCENARIO
• template-preview — แสดงตัวอย่างเทมเพลตรูปทรง
• exporter-playground — ทดลองตัวส่งออกกับผืนผ้าใบที่ใช้งานอยู่
• path-footprint-lab — การทดลอง Path Footprint

ดูเพิ่มเติม

• สถาปัตยกรรมส่วนขยาย — ทำไม iframe และ postMessage
• ภาพรวม @drawtonomy/sdk — แพ็กเกจและ โมดูล