Skip to content

zkytech/iOS14-widgets-for-scriptable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

如果本项目对你有帮助,欢迎在🔗Github点个star表示支持。

联系邮箱:zhangkunyuan@hotmail.com ,PR请提交到🔗Github

iOS 14小组件

使用方法

安装scriptable

安装App Store中的🔗Scriptable

安装脚本

下方各组件的章节内有对应脚本的安装链接,点击下载后用Scriptable APP打开。选择Add to my scripts即可。

使用

  1. 安装scriptable后会自动创建几个Demo脚本,其中有一个脚本是Random Scriptable API,先点击运行一次这个脚本。

  2. 在桌面创建小组件 选择 scriptable

  3. 编辑 小组件,点击选取 script 并选择前面导入的脚本。

小组件:bilibili最近更新番剧列表

效果预览

安装

下载🔗安装脚本后,用scriptable打开

参数

小组件的parameter可以设置以下几个值

参数 必填 值/示例 说明
type 番剧/global/进口 进口番剧
国创/cn/国产 国产动画
all/全部 进口+国产
onlyFollowed 追番/true 仅显示已追
全部/false 未追番 + 已追番
uid 当onlyFollowed为追番/true时 必填 8165988 Bilibili账号的UID,如果要设置仅显示追番,必须同时设定这个值。同时要设置空间公开显示番剧订阅

获取uid:B站APP - 我的 - 点击头像 - 详情

在小组件的编辑界面,按照以下格式进行配置

// 配置格式
type,onlyFollowed,uid  //注意必须用英文逗号

// 示例
示例1: 国创,追番,8165988

示例2: cn,true,8165988

示例3: ,追番,8165988

示例4: ,true,8165988

示例5: 番剧,追番,8165988

示例6: global,true,8165988

示例7: 全部,追番,8165988

示例8: all,true,8165988

配置示例

小组件:LOL近期赛事列表

效果预览

安装

下载🔗安装脚本后,用scriptable打开

小组件:深蓝SL03车辆状态

声明

  • 脚本所展示的信息不保证准确无误,锁车、充电、电量、油量等所有信息仅供参考,请勿将桌面组件展示的数据作为决策依据,由于脚本展示数据错误/误差造成的任何后果,本人概不负责。
  • 脚本需要使用深蓝APP的登录信息来获取数据,安装即代表您同意脚本使用您的登录信息。
    • 所有数据只会存储在您的iCloud云盘或者手机本地,不会上传到任何第三方服务器。

效果预览

特性:

  • 支持 中/小 桌面组件 以及 锁屏组件
  • 桌面小组件展示车辆数据: 电池续航、油箱续航、总里程、车内温度(仅纯电车型)、车辆位置、车辆锁定状态、车辆充电状态、车牌号
  • 主题支持自动跟随系统黑暗模式切换
  • 锁屏组件展示车辆数据: 电量、油量
  • 点击桌面/锁屏组件跳转到深蓝APP控车界面
  • 自定义数据块内容,选择电量百分比、油量百分比、综合续航、剩余流量等

车型颜色需要收集比对各种颜色车子的抓包数据来判断是哪个字段,目前没有足够的数据支撑,所以统一白色,当然,小组件提供了部分自定义选项,你可以自己选择组件风格、车辆颜色、替换车辆图片。

简约风格

模块化风格

自定义数据块

安装

为了节省你的时间,请认真阅读下面的操作步骤,并依照文档进行操作,跳过任何一个字都只会成倍地浪费你的时间。为了帮助小白理解,最下面有抓包操作流程图。

安装组件和获取参数的操作过程对小白来说有一定的难度,但是文档写这么长就是为了让更多的人能顺利装上,只要跟着文档一步步操作就能成功。新手大概需要5~10分钟。

认真阅读文档!不要跳过任何一步!

认真阅读文档!不要跳过任何一步!

认真阅读文档!不要跳过任何一步!

为了顺利打开下面的链接,请在safari浏览器中打开本页面

  1. 确保iCloud是开启状态,
  2. 安装🔗Scriptable APP
  3. 下载🔗桌面组件安装脚本后,用Scriptable打开
  4. 安装scriptable后会自动创建几个Demo脚本,其中有一个脚本是Random Scriptable API,先点击运行一次这个脚本。(如果没有看到Random Scriptable API脚本就在Gallery标签页 -> Great WIdgets里面添加)。
  5. 按照下面章节讲的方法获取Authorization并设置到脚本中。

参数

  • 桌面组件参数: Authorization
  • 锁屏组件参数: 模式
    • 非必填,可以填写:,默认显示电量
    • 请先设置好桌面组件再使用锁屏组件
教程

关注公众号查看视频教程

主题设置、自定义车辆图片、LOGO、型号文本...

目前支持自定义的内容:

  • 型号
  • LOGO
  • 车辆图片

车辆名称车牌号是通过API获取的,如果你没有在深蓝APP中设置车牌号,小组件就拉不到车牌数据。所以这两个需要你自己在深蓝APP中修改,修改后等待系统刷新小组件即可。

地图API获取(仅大号组件需要)

  1. 前往高德开放平台注册账号,并认证个人开发者
  2. 在[应用管理-我的应用]中创建一个应用命名为sl03_widget
  3. 点击应用右侧的添加按钮,key名称设置为sl03_widget_key,服务平台选择Web服务,提交确认
  4. 复制刚刚创建的key,输入到小组件的设置中,保存即可

常见问题

  1. SSL错误?

设置-通用-传输或还原iPhone-还原-还原网络设置

  1. 是不是自动刷新数据?

是,也不是。数据刷新分为两部分:1.你的车子把最新数据上传到深蓝APP的服务器数据库中,车子熄火断电后一般不会再更新数据,启动后会持续更新。2.小组件通过API获取数据库中的数据。

小组件只能控制第2部分的刷新,刷新频率由iOS系统自动调度控制。简单地说,你越关注小组件,小组件刷新频率越高。

小组件下方显示数据刷新时间就是为了在小组件信息滞后的时候提醒你这个数据不是最新的,避免引起进一步的误会。比如你刚锁车不到1分钟,可能看到小组件上面显示车辆是解锁状态,但是数据刷新时间能告诉你这是1分钟前的状态。

  1. 能不能手动刷新数据?

可以实现,但非常不优雅,实用性太低,暂时不考虑做这方面的教程。

方法简单点说就是通过快捷指令触发Scriptable的“刷新全部组件”。

  1. 能否控车?

可能有办法实现,但是鉴于法律责任风险,当前我不会去做更不会公开此类方法。

  1. 点击桌面组件跳转非要先打开一下Scriptable吗?

是的,目前无法绕过,这是IOS系统层面的限制,如果后续系统升级放开相关限制我会更新的。

点击锁屏组件可以直接跳转到深蓝APP。

  1. 为什么不做成独立的APP?

第一,时间成本,我的IOS开发经验不足,前端也不是主要专业方向,只是兴趣;第二,就算做出来了,不太可能通过AppStore的审核。

  1. 为什么不做成模拟登录深蓝账号来拿token,这样小白也轻松很多?

法律风险太大。

本项目部分样式基于bmw-scriptable-widgets开发,感谢作者的开源精神。