@dohana/embed
v0.0.3
Published
Browser SDK nhúng trình quay video Dohana vào website bên thứ ba
Readme
dhn-embeded
Browser SDK nhúng trình quay video Dohana vào website bên thứ ba.
Cài đặt
npm install dhn-embededLuồng xác thực
Backend bên thứ ba gọi Dohana để lấy embed token (giữ API key ở server, không lộ ra browser):
curl -X POST <DOHANA_BASE_URL>/dpm/v1/partner/embed/session \ -H 'Content-Type: application/json' \ -H 'x-api-key: <API_KEY>' \ -d '{ "origin": "https://partner.example.com" }' # => { "embedToken": "...", "expiresIn": 3600 }originphải nằm trong danh sách Partner Origins đã verify của store.Frontend bên thứ ba dùng SDK, truyền hàm
getTokengọi lại backend của chính họ mỗi khi SDK cần token.
Sử dụng
<div id="dpm-recorder" style="width:100%;height:720px"></div>
<script type="module">
import { DhnEmbed } from 'dhn-embeded'
const embed = DhnEmbed.mount({
projectId: '<STORE_ID>',
container: '#dpm-recorder',
baseUrl: 'https://embed.dohana.vn',
getToken: async () => {
const res = await fetch('/api/dpm-embed-token', { method: 'POST' })
const data = await res.json()
return data.embedToken
},
onReady: () => console.log('embed ready'),
onVideoCreated: (payload) => console.log('video created', payload),
onError: (err) => console.error(err),
})
// Dừng và gỡ iframe khi cần
// embed.destroy()
</script>Yêu cầu phía trang nhúng
Trang cha phải chạy HTTPS (secure context), nếu không camera sẽ bị chặn.
Trang cha nên cho phép delegate camera qua header:
Permissions-Policy: camera=(self "https://embed.dohana.vn")(hoặc
camera=*nếu chấp nhận mọi origin).
SDK tự thêm allow="camera; microphone; fullscreen; autoplay" cho iframe.
API
DhnEmbed.mount(options): DhnEmbed
| Option | Kiểu | Mô tả |
|---|---|---|
| projectId | string | Store ID của Dohana (bắt buộc) |
| getToken | () => Promise<string> | Hàm host cấp token mới (bắt buộc) |
| container | HTMLElement \| string | Nơi gắn iframe, mặc định document.body |
| baseUrl | string | Base URL Dohana, mặc định https://embed.dohana.vn |
| width / height | string | Kích thước iframe |
| tokenRefreshIntervalMs | number | Chu kỳ lấy lại token, mặc định 50 phút |
| onReady | () => void | Sau khi token được gửi vào iframe |
| onVideoCreated | (payload) => void | Khi iframe báo tạo video thành công |
| onError | (error) => void | Khi lấy token lỗi |
Instance
refresh(): Promise<void>— lấy token mới ngay.destroy(): void— gỡ iframe, dừng timer, xoá listener.
