常见问题

旅境是一款智能旅行播报助手。当你旅行时，App 会自动识别你当前所在的位置，利用 AI 技术为你实时介绍途经地点的历史文化、风土人情、美食景点等内容。支持驾车、步行、骑行等多种出行方式，自动识别跨省、跨市、跨区、跨镇等行政区域变化，并触发相应播报。

快速上手指南：

1. 从 App Store 下载旅境并打开
2. 授予定位权限（建议选择"始终允许"以支持后台播报）
3. 在「设置 → AI 配置」中填入你的 AI API Key（支持通义千问、DeepSeek、豆包等多种供应商）
4. 在「设置 → 高德配置」中填入高德地图 API Key（用于地图显示和逆地理编码）
5. 返回主界面，开始旅行即可自动播报

详细步骤请查看使用指南页面。

旅境支持多种出行场景。你可以通过「设置 → 定位更新条件」调整定位更新的敏感度：

• 100米 — 适合步行、慢跑（每 100 米检测一次位置变化）
• 200米 — 适合慢跑、骑行
• 500米 — 适合骑行、郊区驾车
• 1公里 — 适合高速驾车、长途旅行

不同的距离阈值会影响播报频率和省电效果，建议根据出行方式选择合适的档位。

旅境的核心功能（AI 播报生成、地图显示、天气查询、逆地理编码）需要网络连接才能正常工作。建议在有 4G/5G 或 Wi-Fi 的环境下使用。目前暂不支持完整的离线模式，但我们正在规划离线 TTS 和本地缓存功能。

旅境目前支持 7 种 AI 供应商，你可以自由选择：

• 通义千问（QWEN） — 阿里云，推荐使用 qwen-plus/qwen-max 模型
• DeepSeek — 深度求索，性价比高
• 豆包（DOUBAO） — 字节跳动
• 智谱 AI（GLM） — 智谱，GLM 系列模型
• 小米（XIAOMI） — MiMo 模型
• Claude — Anthropic
• OpenAI GPT — ChatGPT 系列模型

可在「设置 → AI 配置」中切换供应商并填入相应的 API Key。

不同 AI 供应商的 API Key 获取方式：

• 通义千问：登录阿里云控制台 → 模型服务灵积 → API Key 管理
• DeepSeek：登录 platform.deepseek.com → API Keys
• 豆包：登录火山引擎控制台 → 方舟平台 → API Key
• 智谱 AI：登录 open.bigmodel.cn → API Key
• Claude：登录 console.anthropic.com → API Keys
• OpenAI：登录 platform.openai.com → API Keys

API Key 仅保存在你的设备本地（Keychain），不会上传到任何服务器。

旅境通过 AI 实时生成播报内容。当你到达一个新地方，App 会获取当前地点的省市区镇信息，然后交给 AI 生成一段有温度的介绍。

你可以在「设置 → 播报主题」中选择感兴趣的方面：

🏛️ 景点 · 📖 历史 · 👥 人文 · 🍜 美食 · 📖 民间故事 · 🏔️ 地理地貌 · 📰 最近新闻 · 💰 经济情况

同时支持两种播报模式：
• 简洁模式 — 短小精悍，快速获取核心信息
• 完整模式 — 内容丰富，深度了解一个地方

目前旅境的 AI 播报主要以中文（简体）生成内容。App 界面和播报文案均为中文优化，后续版本会考虑增加对其他语言的支持。如果你有这方面的需求，欢迎通过联系我们页面反馈。

旅境提供三种语音播报方式，可在「设置 → 语音配置」中切换：

• 系统语音（AVSpeechSynthesizer） — 使用 iOS 内置语音合成，无需额外配置，即开即用
• 阿里云 TTS — 提供多种高质量音色（龙小淳、龙小夏、龙安朗等 10+ 种），需要配置阿里云 API Key
• 豆包 TTS — 字节跳动提供的语音合成，需要配置豆包 API Key

建议优先使用阿里云或豆包 TTS，音质更自然，支持更多表现力。

在主界面播放控制区域，点击音色按钮即可快速打开音色选择面板：

阿里云音色包括：龙小淳（知性积极女）、YUMI（正经青年女）、龙小夏（沉稳权威女）、龙安温（优雅知性女）、龙安朗（清爽利落男）等 10 种。

豆包音色包括：爽快思思（活泼少女）、深情蜜蜜（温柔女声）、阳光阳阳（阳光男声）等。

你也可以在「设置 → 语音配置」中预先设置默认音色。

如果听不到播报声音，请按以下步骤排查：

1. 检查音量：确保设备音量已调高，且未处于静音模式
2. 检查蓝牙：如果连接了蓝牙设备，尝试断开后使用扬声器
3. 检查语音配置：确认在「设置 → 语音配置」中已正确配置 TTS（系统语音不需要额外配置）
4. 重启 App：彻底关闭旅境后重新打开
5. 检查 AI 配置：有些 TTS 方式需要 AI API Key 配合使用，确保已正确填写

如果仍然无法解决，请联系我们的支持团队。

旅境使用 高德地图 作为地图和定位服务提供商。需要配置以下密钥才能正常使用：

• Web端 JS API Key — 用于地图显示
• Web服务 REST API Key — 用于逆地理编码（将坐标转为地址）和天气查询
• 安全密钥（securityJsCode） — 用于 API 调用签名验证

以上密钥可在 高德开放平台控制台 申请。

如果定位不准确，请尝试以下方法：

1. 开启精确定位：前往 iPhone「设置 → 隐私与安全性 → 定位服务 → 旅境」，确保"精确定位"已开启
2. 选择定位权限：建议选择"始终"以支持后台播报
3. 到开阔地带：高楼密集区或室内 GPS 信号可能较弱
4. 调整定位距离阈值：在「设置 → 定位更新条件」中，步行建议选 100 米，驾车选 500 米或 1 公里
5. 重启定位：关闭再重新打开定位服务

旅境使用的是百米级定位精度（kCLLocationAccuracyHundredMeters），足以识别街道级别的位置变化。

可以。旅境支持后台定位和后台音频播报：

• 当 App 退到后台时，会持续监测你的位置变化
• 检测到跨区域变化时，会自动生成播报内容并通过语音朗读
• 会在控制中心显示播放信息，方便快速控制
• 支持灵动岛（Dynamic Island）和实时活动（Live Activity）显示当前播报状态

需要在「设置 → 旅境 → 定位」中选择"始终"权限才能使用完整的后台功能。

旅境的天气数据通过高德地图的天气 API 获取，包括当前温度、湿度、风向风力、天气状况（晴/雨/雪等）。获取天气需要在「设置 → 高德配置」中正确填入 Web服务 REST API Key。天气信息会显示在主界面，并作为 AI 播报的参考信息之一。

旅境内置了原生的 SwiftUI 天气动画，根据当前天气状况自动切换不同的动画场景：☀️ 晴天、⛅ 多云、☁️ 阴天、🌧️ 雨天、🌨️ 雪天、⛈️ 雷雨等。所有动画使用 TimelineView 时间驱动，流畅且省电，无需 WebView 加载。

在「设置 → 播报主题」中，你可以选择感兴趣的播报方向，AI 会优先围绕你选择的主题生成内容：

✅ 景点 · ✅ 历史 · ✅ 人文 · ✅ 美食 · ✅ 民间故事 · ✅ 地理地貌 · ✅ 最近新闻 · ✅ 经济情况

全选可以获得最丰富的内容，也可以只选你感兴趣的特定方向。AI 会尽量选择不同的讲述角度，避免每次口吻雷同。

旅境会自动保存你的播报历史记录。点击主界面的历史记录按钮即可查看之前所有的播报内容列表，按时间倒序排列，最多保存 50 条。你可以回看每条播报的完整文本，重温旅途中经过的每个地方的故事。

是的！旅境支持 iPhone 14 Pro 及以上机型的灵动岛和实时活动（Live Activity）。当 App 在后台播报时，你可以在灵动岛或锁屏上看到当前地点名称和播放状态，方便快速查看和恢复 App。

请放心，你的所有 API Key（包括 AI API Key、高德地图 Key）都存储在设备的 Keychain（安全密钥链）中。Keychain 是 iOS 系统级的安全存储，数据经过加密，不会明文保存，也不会被上传到任何服务器或分享给第三方。你的 API Key 仅在你自己的设备上使用。

旅境在使用过程中会持续使用 GPS 定位，因此对电量有一定消耗。以下方法可以帮助节省电量：

1. 调整定位距离阈值：驾车时选择 1 公里的更新间隔，减少定位频率
2. 选择合适的播报模式：简洁模式减少 AI 调用次数
3. 关闭不需要的功能：如不需要天气播报，可在设置中关闭
4. iOS 低电量模式：开启 iPhone 低电量模式可减少后台活动

正常驾车 2 小时约消耗 10-15% 电量（视设备型号和信号环境而定）。