python-shortcuts实战教程：打造个性化天气查询Siri快捷指令

【免费下载链接】python-shortcutsCreate Siri Shortcuts with Python项目地址: https://gitcode.com/gh_mirrors/py/python-shortcuts

python-shortcuts是一个强大的工具，让你能够使用Python创建自定义的Siri快捷指令，轻松扩展iPhone和iPad的自动化能力。本文将带你一步步构建一个实用的天气查询Siri快捷指令，无需复杂编程知识，只需简单配置即可实现语音查询天气的便捷功能。

为什么选择python-shortcuts？⚡

• 简单高效：用Python代码定义快捷指令逻辑，比手动在快捷指令应用中拖拽操作更灵活
• 可复用性：创建的指令可以轻松分享和重复使用
• 扩展性强：支持调用Web API、处理文件、数据计算等高级功能
• 丰富资源：项目提供完整的Python教程和TOML教程，帮助新手快速上手

准备工作：环境搭建步骤

1. 安装python-shortcuts

首先克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/py/python-shortcuts cd python-shortcuts

然后使用Pipenv安装依赖：

pipenv install pipenv shell

2. 准备天气API密钥

我们将使用网络API获取天气数据，你需要先注册一个免费的天气API服务（如OpenWeatherMap），获取API密钥后保存备用。

实战开发：构建天气查询快捷指令

第一步：创建Python脚本文件

在项目根目录创建weather_shortcut.py文件，导入必要的模块：

from shortcuts import Shortcut, actions

第二步：定义快捷指令结构

使用python-shortcuts提供的API构建指令流程：

# 创建快捷指令对象 shortcut = Shortcut() # 添加询问用户位置的动作（使用输入模块） shortcut.actions.append(actions.AskForInput( question="请问你想查询哪个城市的天气？", default_answer="北京" )) # 添加获取天气数据的Web请求动作（使用网络模块） shortcut.actions.append(actions.GetURL( url="https://api.openweathermap.org/data/2.5/weather?q={city}&appid={your_api_key}&units=metric", # 这里将使用用户输入的城市作为变量 )) # 添加解析JSON数据的动作（使用字典模块） shortcut.actions.append(actions.DictionaryGet( dictionary="", # 将自动使用上一步的结果 key="main.temp" )) # 添加显示结果的动作（使用消息模块） shortcut.actions.append(actions.ShowResult( text="当前温度：{temp}°C", ))

第三步：生成Siri快捷指令文件

添加生成.shortcut文件的代码：

# 保存为快捷指令文件 shortcut.dump("weather_query.shortcut")

第四步：运行脚本生成指令

执行Python脚本生成快捷指令文件：

python weather_shortcut.py

部署与使用：在iPhone上配置

1. 将生成的weather_query.shortcut文件通过AirDrop发送到你的iPhone
2. 点击文件会自动在"快捷指令"应用中打开
3. 按照提示完成API密钥的配置（如果使用变量）
4. 在Siri设置中添加语音指令，例如"查询天气"

进阶技巧：扩展功能

添加错误处理

使用条件判断动作处理API请求失败的情况：

# 在Web请求后添加条件判断 shortcut.actions.append(actions.If( condition=actions.Condition( left=actions.Variable("Status Code"), operation="is", right=200 ), true_actions=[...], # 正常处理流程 false_actions=[ actions.ShowResult(text="获取天气失败，请稍后重试") ] ))

增加多信息展示

扩展显示内容，包括天气状况和体感温度：

# 添加多个字典获取动作 shortcut.actions.append(actions.DictionaryGet(key="weather.0.description")) shortcut.actions.append(actions.DictionaryGet(key="main.feels_like")) # 格式化显示文本 shortcut.actions.append(actions.ShowResult( text="当前{city}：{description}，温度{temp}°C，体感{feels_like}°C" ))

参考资源

• 官方文档：TOML教程
• Python API指南：Python教程
• 更多示例：examples/目录包含各种功能的实现代码

通过python-shortcuts，你可以轻松创建各种实用的Siri快捷指令，从简单的文本处理到复杂的API集成。这个天气查询指令只是一个开始，发挥你的创意，打造更多个性化的自动化工具吧！🚀

【免费下载链接】python-shortcutsCreate Siri Shortcuts with Python项目地址: https://gitcode.com/gh_mirrors/py/python-shortcuts