开发 SKILL 专区 开发者技能 AIoT智能眼镜SDK SKILL

AIoT智能眼镜SDK SKILL 最后更新时间: 2026年03月10日

产品介绍

高德地图 AMap SDK Skills 是一套专为 AI IDE 设计的 AI 编程技能包。它将高德地图多个平台 SDK(RTOS、Android、iOS)的官方文档、最佳实践和代码模板整合为结构化的技能文件,使 Cursor、Claude、Cline 等 AI Coding 工具能够:

  • 精准理解高德地图各平台 SDK 的使用方法
  • 自动生成符合官方规范的 SDK 集成代码
  • 主动避免常见的开发陷阱和兼容性问题
  • 提供经过验证的完整代码示例

无论您是地图 SDK 开发新手还是资深开发者,这套 Skills 都能显著提升您的开发效率。

包含的 Skills

Skill

平台

说明

RTOS 地图 SDK

RTOS

面向智能眼镜、智能手表等 RTOS 设备的轻量级地图 SDK,支持栅格/矢量地图渲染与轨迹导航

Android LLM Agent SDK

Android

AI 智能导航助手 Android 版 SDK,支持自然语言交互、路线规划、导航控制

iOS LLM Agent SDK

iOS

AI 智能导航助手 iOS 版 SDK,支持自然语言交互、路线规划、导航控制


产品特点

多平台覆盖

覆盖 RTOS、Android 和 iOS 平台,为高德地图 SDK 在主流平台的集成提供全面的 AI 编程辅助。

模块化设计

每个 Skill 按功能模块组织文档(初始化、地图操作、导航、覆盖物等),AI 可按需引用,精准回答您的问题。

代码可验证

所有代码示例均经过实际 SDK API 验证,AI 会自我校验生成代码的可用性,确保输出可以正确编译和运行。


能力介绍

RTOS 地图 SDK

地图渲染

能力

说明

地图初始化

SDK 初始化、设备激活、地图创建

栅格/矢量地图

标准栅格和卫星瓦片样式

视图控制

缩放、旋转、中心点调整

生命周期管理

初始化、激活、创建、渲染、销毁流程

覆盖物

能力

说明

点标注

地图上的点标注

线标注

路线和轨迹的线标注

面标注

区域标注

覆盖物管理

添加、移除、更新覆盖物

导航

能力

说明

轨迹导航

实时导航数据展示

导航回调

转向数据、距离、预计到达时间

转向图标

导航转向方向图标

平台适配器

能力

说明

内存适配器

malloc/free/realloc 实现

文件适配器

文件 I/O 操作

网络适配器

HTTP 请求处理

渲染适配器

地图渲染到屏幕(最关键)

系统适配器

系统时间、设备信息

线程适配器

线程创建与同步

关键约束: 所有 SDK 方法必须在同一主流程线程调用(单线程模型),统一使用 GCJ02 坐标系,首次使用需联网激活设备。

Android/iOS LLM Agent SDK

核心功能

能力

说明

自然语言意图识别

发送语音/文字查询进行智能地图交互

识别结果指令分发

分发调用导航、搜索、定位等基础能力

LinkClient

与高德 APP 通信实现跨应用功能

配置

能力

说明

出行方式

驾车、步行、骑行

日志配置

SDK 内部日志配置

生命周期

场景管理、状态机流转

版本依赖

使用 RTOS、Android、iOS的skill均需要依赖对应的SDK产物,才能正常生成可用代码示例。

如下依赖的SDK产物,请联系高德相关同学获取最新依赖包

RTOS 地图 SDK

依赖RTOS的SDK产物

Android/iOS LLM Agent SDK

依赖Android/iOS的Agent SDK、导航SDK产物

快速接入

第一步:获取 Skills 文件

GitHub仓库地址:https://github.com/amap-demo/amap-sdk-skills

方式一:Git Clone(推荐)

# 克隆仓库到本地
git clone git@github.com:amap-demo/amap-sdk-skills.git

# 进入目录
cd amap-sdk-skills

方式二:直接下载

点击下载最新版本的压缩包并解压。 

第二步:在 Cursor 中配置 Skill

Cursor 支持通过 .cursor/skills/ 目录加载自定义技能。

2.1 创建 Skills 目录

在您的项目根目录下创建 .cursor/skills/ 文件夹:

mkdir -p .cursor/skills

2.2 链接或复制 Skill 文件

  • 方式一:软链接(推荐,方便更新)
# macOS - 链接您需要的 Skill
ln -s /path/to/amap-sdk-skills/RTOS .cursor/skills/RTOS
ln -s /path/to/amap-sdk-skills/android-llm-agent .cursor/skills/android-llm-agent
ln -s /path/to/amap-sdk-skills/ios-llm-agent-sdk .cursor/skills/ios-llm-agent-sdk

# Windows(以管理员身份运行 CMD)
mklink /D .cursor\skills\RTOS C:\path\to\amap-sdk-skills\RTOS
mklink /D .cursor\skills\android-llm-agent C:\path\to\amap-sdk-skills\android-llm-agent
mklink /D .cursor\skills\ios-llm-agent-sdk C:\path\to\amap-sdk-skills\ios-llm-agent-sdk
  • 方式二:直接复制
cp -r /path/to/amap-sdk-skills/RTOS .cursor/skills/
cp -r /path/to/amap-sdk-skills/android-llm-agent .cursor/skills/
cp -r /path/to/amap-sdk-skills/ios-llm-agent-sdk .cursor/skills/

2.3 项目目录结构

配置完成后,您的项目目录结构应该类似(图片以 Android LLM Agent SDK 的 skill 为例):

your-project/
├── .cursor/
│   └── skills/
│       ├── RTOS/                       # RTOS 地图 SDK Skill
│       │   ├── SKILL.md
│       │   ├── api/
│       │   └── references/
│       ├── android-llm-agent/          # Android LLM Agent Skill
│       │   ├── SKILL.md
│       │   ├── api/
│       │   └── references/
│       └── ios-llm-agent-sdk/          # iOS LLM Agent Skill
│           ├── SKILL.md
│           ├── api/
│           └── references/
├── src/
└── ...

第三步:验证配置

打开 Cursor IDE,打开您的项目,按 Cmd/Ctrl + L 打开 AI Chat,输入测试问题:

RTOS 测试:

帮我在当前文件夹生成一个iOS Demo,采用OC编写,接入RTOS SDK,并展示一张地图,我已经在当前文件夹下提供了必要头文件和库文件

Android 测试:

新建一个安卓工程,接入 LLM Agent SDK

iOS 测试:

新建一个iOS的UIViewController的demo 页面,接入 LLM Agent SDK

下图,以Android测试为例(需先引入依赖的Android agent SDK、导航SDK的产物)

如果 AI 在思考过程中能够正确引用 Skill 文件并生成完整的、符合规范的代码,说明 Skill 已成功加载。

使用示例

RTOS 示例

示例 1:SDK 初始化

在 iOS 平台上初始化 WatchSDK,实现所有必需的适配器,包括内存、文件、网络、渲染、系统和线程适配器

示例 2:创建地图

创建一个以北京为中心、缩放级别为 12 的地图视图,使用标准栅格瓦片样式

示例 3:导航集成

初始化导航模块并设置回调,接收实时导航数据,包括转向方向和剩余距离

Android 示例

示例 1:SDK 初始化

在 Android 应用类中初始化 LLM Agent SDK,并做好生命周期管理

示例 2:自然语言查询

发送自然语言查询"导航到北京首都机场",并处理路径规划结果

示例 3:LinkClient 集成

配置 LinkClient 与高德 APP 通信,实现跨应用导航

iOS 示例

示例 1:Agent 初始化

在 iOS 应用中初始化 LLM Agent SDK,注册导航命令并设置查询回调

示例 2:自然语言查询

发送自然语言查询"找到最近的加油站并导航过去",并处理路径规划结果

示例 3:Link SDK 集成

配置 Link SDK 与高德 APP 通信,实现授权流程、建立连接并发送导航命令

目录结构

amap-sdk-skills/
├── RTOS/                               # RTOS 地图 SDK Skill
│   ├── SKILL.md                        # 技能主文件(AI 入口)
│   ├── api/                            # API 使用指南
│   │   ├── quick-start.md              # 快速开始
│   │   ├── ios-integration.md          # iOS 集成指南
│   │   ├── lifecycle.md                # 生命周期管理
│   │   ├── adapters.md                 # 适配器实现
│   │   ├── map-operations.md           # 地图操作
│   │   ├── overlays.md                 # 覆盖物管理
│   │   └── navigation.md              # 导航
│   └── references/                     # 参考资料
│       ├── adapter-requirements.md     # 适配器必需函数
│       ├── core-types.md               # 核心类型定义
│       ├── error-codes.md              # 错误码
│       └── troubleshooting.md          # 常见问题
├── android-llm-agent/                  # Android LLM Agent SDK Skill
│   ├── SKILL.md                        # 技能主文件(AI 入口)
│   ├── api/                            # API 使用指南
│   │   ├── quick-start.md              # 快速开始
│   │   ├── agent-query.md              # AI 查询
│   │   ├── query-result.md             # 查询结果处理
│   │   ├── link-client.md              # LinkClient 通信
│   │   ├── transport-mode.md           # 出行方式
│   │   ├── logger.md                   # 日志配置
│   │   └── lifecycle.md                # 生命周期管理
│   └── references/                     # 参考资料
│       ├── core-classes.md             # 核心类
│       ├── troubleshooting.md          # 常见问题
│       └── voice-commands.md           # 语音指令
└── ios-llm-agent-sdk/                  # iOS LLM Agent SDK Skill
    ├── SKILL.md                        # 技能主文件(AI 入口)
    ├── api/                            # API 使用指南
    │   ├── quick-start.md              # 快速开始
    │   ├── integrate-agent.md          # Agent 集成
    │   ├── agent-query.md              # AI 查询
    │   ├── query-result.md             # 查询结果处理
    │   ├── navi-control.md             # 导航控制
    │   ├── navi-data-listener.md       # 导航数据监听
    │   ├── link-quick-start.md         # Link 快速开始
    │   ├── link-client.md              # LinkClient 管理
    │   ├── authorization.md            # 认证管理
    │   ├── connection.md               # 连接管理
    │   ├── data-transfer.md            # 数据传输
    │   ├── transport-mode.md           # 出行方式
    │   ├── logger.md                   # 日志配置
    │   └── lifecycle.md                # 生命周期管理
    └── references/                     # 参考资料
        ├── core-classes.md             # 核心类
        ├── link-core-classes.md        # Link 核心类
        ├── link-error-codes.md         # Link 错误码
        ├── troubleshooting.md          # 常见问题
        └── voice-commands.md           # 语音指令

常见问题

Q:RTOS/Android/iOS - SDK Skill的依赖包无法下载

A:使用RTOS、Android、iOS的skill,均依赖对应的SDK包产物,请联系高德相关同学获取最新依赖包。

Q:我应该使用哪个 Skill?

A:根据您的目标平台选择:

  • RTOS 设备(智能眼镜、智能手表):使用 RTOS Skill
  • Android 应用 AI 导航:使用 android-llm-agent Skill
  • iOS 应用 AI 导航:使用 ios-llm-agent-sdk Skill

Q:可以同时使用多个 Skill 吗?

A:可以!您可以同时将多个 Skill 目录链接到 .cursor/skills/ 中。Cursor AI 会根据您的问题自动引用相关的 Skill。

Q:Cursor AI 没有使用 Skill 中的知识

A:请确保:

  1. Skill 文件放置在 .cursor/skills/ 目录下
  2. SKILL.md 文件存在且格式正确
  3. 尝试在提问时明确提及 SDK 名称(如"WatchSDK"、"Android LLM Agent"、"iOS LLM Agent")

Q:如何更新 Skill?

A:如果使用软链接方式,只需拉取仓库的最新更改即可。如果使用复制方式,需要重新复制最新文件。

Q:Android/iOS - Link SDK 授权失败

A:请确保:

  1. 设备上已安装最新版本的高德APP
  2. 授权配置正确
  3. 查看 Link 错误码参考文档中的错误码说明

相关链接


让 AI 成为您的高德 SDK 开发助手,从今天开始!

返回顶部 示例中心 常见问题 智能客服 公众号
二维码