车辆信息 Vehicle

Vehicle API 提供车辆档案和状态查询能力。

在线试用

getCurrentVehicleProfilegetCurrentVehicleStatus同时获取

点击上方按钮加载数据

车辆 API 试用

拉取当前车辆档案与实时状态，以键值对形式展示（mock 数据）

Vue

<script setup>
import { ref, onMounted } from 'vue'
import woo from 'mini-sdk'

const profile = ref(null)
const status = ref(null)

onMounted(async () => {
  profile.value = await woo.getCurrentVehicleProfile()
  status.value = await woo.getCurrentVehicleStatus()
})
</script>

<template>
  <div v-if="profile">
    <p>{{ profile.brand }} {{ profile.model }} ({{ profile.year }})</p>
    <p>VIN: {{ profile.vin }}</p>
  </div>
  <div v-if="status">
    <p>电量: {{ status.batteryLevel }}% | 里程: {{ status.odometer }}km</p>
  </div>
</template>

React

import { useState, useEffect } from 'react'
import woo from 'mini-sdk'

function VehicleInfo() {
  const [profile, setProfile] = useState(null)
  const [status, setStatus] = useState(null)

  useEffect(() => {
    woo.getCurrentVehicleProfile().then(setProfile)
    woo.getCurrentVehicleStatus().then(setStatus)
  }, [])

  return (
    <>
      {profile && (
        <div>
          <p>{profile.brand} {profile.model} ({profile.year})</p>
          <p>VIN: {profile.vin}</p>
        </div>
      )}
      {status && (
        <p>电量: {status.batteryLevel}% | 里程: {status.odometer}km</p>
      )}
    </>
  )
}

导入

import woo from 'mini-sdk'
// 或
import { vehicle } from 'mini-sdk'

API 列表

getCurrentVehicleProfile

获取当前绑定车辆的档案信息。

const profile = await woo.getCurrentVehicleProfile()

返回值 VehicleProfile：

字段	类型	说明
vin	string	车辆识别码
brand	string	品牌
model	string	型号
year	number	年份
color	string	颜色
licensePlate	string	车牌号

const profile = await woo.getCurrentVehicleProfile()
console.log(`${profile.brand} ${profile.model} (${profile.year})`)

---

getCurrentVehicleStatus

获取当前车辆的实时状态。

const status = await woo.getCurrentVehicleStatus()

返回值 VehicleStatus：

字段	类型	说明
mileage	number	总里程 (km)
fuelLevel	number	油量百分比
batteryLevel	number	电量百分比
isLocked	boolean	是否锁车
location	{ lat: number, lng: number }	车辆位置

const status = await woo.getCurrentVehicleStatus()

if (status.fuelLevel < 20) {
  woo.showToast({ title: '油量不足，请及时加油', icon: 'none' })
}

API 速查表

方法	说明	签名
getVehicleInfo	获取车辆基本信息	() → Promise<VehicleInfo>
getVehicleStatus	获取车辆实时状态	() → Promise<VehicleStatus>
onVehicleStatusChange	监听车辆状态变化	(callback) → void