車両情報 Vehicle

Vehicle API は、車両のプロフィールとステータスを照会する機能を提供します。

オンラインで試す

getCurrentVehicleProfilegetCurrentVehicleStatus両方取得

上のボタンを押してデータを読み込みます

Vehicle API デモ

現在紐づいている車両のプロフィールとリアルタイムのステータスを取得し、キーと値の形式で表示します（モックデータ）

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	車両識別番号（VIN）
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' })
}

早見表

メソッド	説明	シグネチャ
getVehicleInfo	車両の基本情報を取得する	() → Promise<VehicleInfo>
getVehicleStatus	車両のリアルタイムのステータスを取得する	() → Promise<VehicleStatus>
onVehicleStatusChange	車両ステータスの変化を監視する	(callback) → void