setWidgetState

setWidgetState là JS API dùng để cập nhật và đồng bộ trạng thái persistent của widget lên Host app. Trạng thái này được lưu trữ bền vững và chia sẻ với widgetState.

Import

import apis from '@v-miniapp/ai/apis'

Tham số

Thuộc tính	Kiểu dữ liệu	Bắt buộc	Mô tả
state	Record<string, unknown>	✅	Object trạng thái mới cần lưu
success	() => void		Callback khi đồng bộ thành công
fail	(error) => void		Callback khi thất bại
complete	() => void		Callback khi hoàn tất (dù thành công hay thất bại)

Giá trị trả về

• void

Ví dụ

Callback

import apis from '@v-miniapp/ai/apis'

apis.setWidgetState({
  state: { counter: 1, lastUpdated: Date.now() },
  success: () => {
    console.log('Đã lưu trạng thái')
  },
  fail: (err) => {
    console.error('Lỗi', err)
  },
})

Async/Await

import { apisAsync } from '@v-miniapp/ai/apis'

try {
  await apisAsync.setWidgetStateAsync({ counter: 1, lastUpdated: Date.now() })
  console.log('Đã lưu trạng thái')
} catch (err) {
  console.error('Lỗi', err)
}