由于此版本变动很大,所以改了 AppID。喜欢用老版本 v2.0 的也可以继续使用。
原版 v2.0 链接:
https://www.bandbbs.cn/threads/4141/
一、有什么新功能?
1. 密码保护
可选配置。适用于不想给手环上密码,但是又希望保护两步验证码安全的用户。用户可以设置六位数密码,BandTOTP v3.0 在启动时将进行验证。
提醒:从安全角度出发,最好不要安装文件浏览小程序。配置文件是以明文储存的,他人通过文件浏览小程序可以轻易盗取你的 OTPKey。
浏览附件14183
2. 文件夹分组+多验证码显示
在 BandTOTP v3.0 中,所有账号以文件夹形式分类储存。你可以创建无数个文件夹,然后在每个文件夹中添加无数个账号。每个账号及其验证码会以卡片形式展示。
在多账号卡片视图中,屏幕会保持常亮 60 秒。
提醒:由于设备性能限制,请不要在同一文件夹中添加太多账号。
浏览附件14184
浏览附件14185
3. 自定义标题栏
你可以自定义主页的标题栏。若不进行配置,会默认设置为“BandTOTP”。
示意图请见 一.2 中配图。
二、配置指南
需要懂一点 json 语法。很简单的,搜一下教程几分钟就能学会。
在此版本中,不必将 json 文件压缩为一行。
更详细的解释可以看 v2.0 的配置指南。
默认配置文件如下,我添加了一些注释以便理解。标记“(可选)”字样的配置项可以不写。
JSON:
{
"CustomTitle": "BandTOTP_LZC256", // (可选) 自定义标题栏。不进行配置,默认为“BandTOTP”
"MasterPassword": "114514", // (可选) 主密码。(2022.09.10)必须是 6 位数。可以是整数或者字符串,推荐设置为字符串,也就是加上英文双引号。整数形式首位数字不得为 0。当然,请不要设置一个这么臭的密码,别人一试就试出来了。
"Folders": [{ // 文件夹配置
"Name": "Personal", //文件夹名称(随便写)
"Credentials": [{ //文件夹中账号配置
"Name": "Example11", // 自定义名称(随意写)
"OTPKey": "JBSWY3DPEHPK3PXP" // OTP Key Secret
}, {
"Name": "FCCC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}, {
"Name": "FCCeeC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}, {
"Name": "FCCeddeeeeC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}]
},
{
"Name": "Work",
"Credentials": [{
"Name": "Example11",
"OTPKey": "JBSWY3DPEHPK3PXP"
}, {
"Name": "FCCC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}, {
"Name": "FCCeeC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}, {
"Name": "FCCeddeeeeC",
"OTPKey": "JBSWY3DPEHPK3PXP"
}]
}
]
}
按照示例写好配置文件后,请保存为 UTF-16 LE BOM 编码,命名为 config.json 并放入 assets 目录。
安装到手环,现在可以正常使用了。
三、常见问题
1. 卡进了一个奇怪的页面,标题是“FATAL”,下面一堆英文。
这是 BandTOTP 的错误页面。大部分都是因为你的配置文件不正确而导致报错。在拍照提问前,请先用翻译软件翻译一下其中的英文,错误信息写得明明白白,大部分错误是用户可以自行解决的。当然,要是你解决不了,也可以提问。
注意:写这个错误页面花了我半个小时,初衷是减少无意义的提问,增强大家动手能力。所以出错的时候请不要看都不看一眼就提问,可以吗?
2. 主界面绿了
请退出到表盘,然后重新进入 BandTOTP v3.0。
3. 在错误页面绿了,左划没法退出
我自己测试的时候还真的遇到过。这种情况下,可以尝试删除小程序重新安装,或者覆盖安装小程序。
4. (2022.09.10) 无法使用 Epic 或者 Amazon 两步验证(或者:我已经填入了正确的 OTPKey,但是验证码的位置显示一串英文报错)
目前已知 Epic 或者 Amazon 两步验证会出现此问题。这是由于 OTPKey 长度不合规,无法通过 Hex 完整性验证导致。
解决办法:在 OTPKey 后面补上一个大写字母 A,使 OTPKey 长度为偶数。如果还是不行,请继续补全,直到 OTPKey 长度为 8 的倍数。
四、其他
昨天二十几发出了宵宫,今天单抽出了飞雷,太高兴了。一时兴起,肝了一天,从 Helloworld 模板开始重写了整个 BandTOTP。