Phương thức thể hiện

Tóm tắt phương pháp

Phương pháp	Mục đích
destroy()	Gỡ bỏ iframe và thả các trình lắng nghe sự kiện.
getState()	Đọc trạng thái vòng đời SDK hiện tại.
whenReady()	Chờ đến khi iframe hoàn tất khởi tạo.
setSymbol(biểu tượng)	Chuyển đổi cặp giao dịch bên trong iframe.
setTheme(chủ đề)	Cập nhật tham số chủ đề iframe.
setLocale(địa phương)	Chuyển đổi ngôn ngữ iframe.
setSize(chiều rộng, chiều cao)	Cập nhật kích thước iframe.
reload()	Tải lại iframe hiện tại.
refreshAuth(lý do)	Kích hoạt luồng làm mới xác thực widget.
setTokenProvider(nhà cung cấp)	Thay thế nhà cung cấp được sử dụng bởi chế độ token đối tác.
on(event, handler)	Đăng ký nhận các sự kiện thời gian chạy và nhận chức năng hủy đăng ký.

destroy()

Gỡ bỏ iframe, xóa listener và phát hành đã hủy một lần cho phiên bản hiện tại.

1 widget.destroy()

getState()

Đọc trạng thái vòng đời hiện tại của thể hiện widget.

1 const state = widget.getState()

Các giá trị trả về bao gồm loading, authenticating, ready, error và destroyed.

whenReady()

Chờ iframe hoàn tất khởi tạo trước khi chạy logic giao diện phụ thuộc.

1 await widget.whenReady()

setSymbol(biểu tượng)

Chuyển đổi cặp giao dịch bên trong iframe. Nếu iframe vẫn đang khởi tạo, SDK sẽ xếp hàng lệnh và gửi sau khi đã sẵn sàng.

1 widget.setSymbol('ETHUSDT')

setTheme(chủ đề)

Cập nhật tham số chủ đề được sử dụng bởi iframe giao dịch nhúng.

1 widget.setTheme('dark')
2 widget.setTheme('light')

setLocale(địa phương)

Chuyển đổi ngôn ngữ iframe. Các giá trị được hỗ trợ là en, en-US và zh-CN.

1 widget.setLocale('en')
2 widget.setLocale('en-US')
3 widget.setLocale('zh-CN')

setSize(chiều rộng, chiều cao)

Cập nhật kích thước DOM iframe và thông báo cho iframe về kích thước ngoài mới. Giá trị số được chuyển đổi thành px.

1 widget.setSize('100%', 720)

reload()

Tải lại iframe hiện tại và chờ nó khởi tạo lại.

1 widget.reload()

refreshAuth(lý do)

Yêu cầu iframe làm mới luồng xác thực hiện tại. Giá trị lý do tùy chọn được chuyển tiếp cho ghi nhật ký và kiểm soát luồng.

1 widget.refreshAuth('manual')

setTokenProvider(nhà cung cấp)

Thay thế tokenProvider được sử dụng bởi chế độ token đối tác. SDK gọi nhà cung cấp khi iframe yêu cầu token nhúng mới.

1 widget.setTokenProvider(async ({ channelId, symbol, reason }) => {
2   const resp = await fetch('/api/trading/embed-token', {
3     method: 'POST',
4     credentials: 'include',
5     headers: { 'Content-Type': 'application/json' },
6     body: JSON.stringify({ channelId, symbol, reason }),
7   })
8 
9   return resp.json()
10 })

on(event, handler)

Đăng ký một sự kiện thời gian chạy. Hàm trả về sẽ xóa trình lắng nghe.

1 const off = widget.on('order_created', (event) => {
2   console.log(event)
3 })
4 
5 off()