由于此版本变动很大，所以改了 AppID。喜欢用老版本 v2.0 的也可以继续使用。
原版 v2.0 链接：
https://www.bandbbs.cn/threads/4141/
一、有什么新功能？
1. 密码保护
可选配置。适用于不想给手环上密码，但是又希望保护两步验证码安全的用户。用户可以设置六位数密码，BandTOTP v3.0 在启动时将进行验证。
提醒：从安全角度出发，最好不要安装文件浏览小程序。配置文件是以明文储存的，他人通过文件浏览小程序可66以轻易盗取你的 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。
米坛社区 2024 下半年社区版主招募中🔥
