Metode Instans | 6MM Docs

Ringkasan Metode

Metode	Tujuan
menghancurkan()	Hapus iframe dan lepaskan pendengar acara.
getState()	Baca status siklus hidup SDK saat ini.
whenReady()	Tunggu hingga iframe selesai inisialisasi.
setSymbol(simbol)	Ganti pasangan perdagangan di dalam iframe.
setTheme(tema)	Perbarui parameter tema iframe.
setLocale(lokal)	Ganti bahasa iframe.
setSize(lebar, tinggi)	Perbarui dimensi iframe.
memuat ulang()	Muat ulang iframe saat ini.
refreshAuth(alasan)	Memicu aliran penyegaran autentikasi widget.
setTokenProvider(penyedia)	Ganti penyedia yang digunakan dengan mode token mitra.
aktif (acara, pengendali)	Berlangganan acara runtime dan terima fungsi berhenti berlangganan.

menghancurkan()

Hapus iframe, hapus pendengar, dan emit yang dimusnahkan satu kali untuk instance saat ini.

widget.destroy()

getState()

Baca status siklus hidup instance widget saat ini.

const state = widget.getState()

Nilai yang dikembalikan mencakup memuat, mengautentikasi, siap, kesalahan, dan dimusnahkan.

whenReady()

Tunggu hingga iframe menyelesaikan inisialisasi sebelum menjalankan logika UI dependen.

await widget.whenReady()

setSymbol(simbol)

Ganti pasangan perdagangan di dalam iframe. Jika iframe masih melakukan inisialisasi, SDK mengantri perintah dan mengirimkannya setelah siap.

widget.setSymbol('ETHUSDT')

setTheme(tema)

Perbarui parameter tema yang digunakan oleh iframe perdagangan yang disematkan.

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

setLocale(lokal)

Ganti bahasa iframe. Nilai yang didukung adalah en, en-US, dan zh-CN.

widget.setLocale('en')
widget.setLocale('en-US')
widget.setLocale('zh-CN')

setSize(lebar, tinggi)

Perbarui ukuran iframe DOM dan beri tahu iframe tentang ukuran luar yang baru. Nilai numerik dikonversi ke px.

widget.setSize('100%', 720)

memuat ulang()

Muat ulang iframe saat ini dan tunggu hingga diinisialisasi lagi.

widget.reload()

refreshAuth(alasan)

Minta iframe untuk menyegarkan alur autentikasi saat ini. Nilai alasan opsional diteruskan untuk logging dan kontrol aliran.

widget.refreshAuth('manual')

setTokenProvider(penyedia)

Ganti tokenProvider yang digunakan oleh mode token mitra. SDK memanggil penyedia ketika iframe meminta token penyematan baru.

widget.setTokenProvider(async ({ channelId, symbol, reason }) => {
  const resp = await fetch('/api/trading/embed-token', {
    method: 'POST',
    credentials: 'include',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ channelId, symbol, reason }),
  })
  return resp.json()
})

aktif (acara, pengendali)

Berlangganan ke acara runtime. Fungsi yang dikembalikan menghapus pendengar.

const off = widget.on('order_created', (event) => {
  console.log(event)
})
off()

Metode tambahan dalam runtime v1 saat ini

Metode	Tujuan
`whenRendered()`	Tunggu notifikasi yang diberikan iframe; ini terpisah dari siap.
`setPage(page)`	Minta halaman produk yang didukung dalam contoh saat ini. Itu tidak mengubah lingkungan dana.
`prepareForRecreate()`	Minta iframe yang sudah siap untuk mempersiapkan penggantian; mengembalikan janji dan dapat menolak jika tidak tersedia, sibuk, atau waktu habis.
`cancelRecreate()`	Membatalkan aliran penggantian yang tertunda/disiapkan.
`TradingWidget.validateOptions(options)`	Validasi opsi inisialisasi sebelum membuat instance.

Untuk perubahan lingkungan pengguna atau nyata/demo, hancurkan instance lama dan buat yang baru dengan otentikasi dan mode target. Jangan gunakan setPage sebagai pengalih lingkungan. Periksa kemampuan sebelum menggunakan metode opsional.

if (TradingWidget.capabilities.methods.includes('whenRendered')) {
  await widget.whenRendered();
}
if (TradingWidget.capabilities.pages.includes('up-down')) {
  widget.setPage('up-down');
}