AWS AppSync IoT Core 实时仪表板开源项目最佳实践

2025-05-16 18:35:35作者：曹令琨Iris

1. 项目介绍

本项目是基于AWS AppSync和IoT Core的实时仪表板示例，它展示了如何将AWS的云服务与物联网设备相结合，创建一个可扩展、高度可用的实时数据流处理系统。该仪表板能够接收来自IoT设备的消息，并通过AppSync实时同步到前端界面，实现数据的即时展示。

2. 项目快速启动

以下是快速启动本项目的基本步骤：

首先，确保您已经配置了AWS CLI并具备必要的权限。

# 克隆项目
git clone https://github.com/aws-samples/aws-appsync-iot-core-realtime-dashboard.git

# 进入项目目录
cd aws-appsync-iot-core-realtime-dashboard

# 安装依赖
npm install

# 启动前端服务
npm run start

在浏览器中打开 http://localhost:3000，您应该能够看到仪表板的界面。

3. 应用案例和最佳实践

3.1 设备数据上报

确保您的IoT设备已经正确配置了MQTT客户端，并且可以连接到AWS IoT Core。以下是一个简单的MQTT消息发送示例：

import paho.mqtt.client as mqtt

# MQTT服务器地址
MQTT_HOST = "your-mqtt-endpoint.iot region.amazonaws.com"
# MQTT端口
MQTT_PORT = 8883
# MQTT主题
MQTT_TOPIC = "your/topic"

# 初始化MQTT客户端
client = mqtt.Client()

# 连接MQTT服务器
client.connect(MQTT_HOST, MQTT_PORT, 60)

# 发送消息
client.publish(MQTT_TOPIC, payload='{"temperature": 25.5, "humidity": 60.2}', qos=1)

# 断开连接
client.disconnect()

3.2 AppSync数据同步

在AppSync中创建一个数据源，并设置相应的分辨率和策略。以下是一个基本的AppSync订阅示例：

subscription OnTemperatureUpdate($temperature: Float!) {
  onTemperatureUpdate(temperature: $temperature) {
    temperature
    humidity
    timestamp
  }
}

3.3 前端实时更新

在前端使用AppSync的JavaScript SDK来实现数据的实时更新。以下是一个简单的使用示例：

import { createClient } from 'aws-appsync';
import { AWSAppSyncClient } from 'aws-appsync';
import gql from 'graphql-tag';

// 创建AppSync客户端
const client = createClient({
  url: 'your-appsync-endpoint',
  region: 'your-region',
  auth: {
    // 配置认证信息
  },
});

// 订阅数据更新
const SUBSCRIPTION = gql`
  subscription OnTemperatureUpdate {
    onTemperatureUpdate {
      temperature
      humidity
      timestamp
    }
  }
`;

client.subscribe({ query: SUBSCRIPTION }).subscribe({
  next: (data) => {
    console.log('Received data:', data);
  },
  error: (error) => {
    console.error('Subscription error:', error);
  },
});