SkyAutoPlayerScript

English: README-en.md

使用 AutoX 提供的无障碍权限实现在 Sky光遇中自动弹奏 SkyStudio 导出的曲谱

~~不会进一步支持原神的21键琴和上传21键位的共享乐谱，反正15键又不是不能弹。~~

暂时解决 `Syntax error script.js#44(eval)#100` 的方法

特性

相比于其他脚本，SkyAutoPlayerScript 拥有以下优势

全 GUI 操作，无需编辑任何代码，流畅的UI动画。
多功能的弹奏控制面板，支持暂停， 进度控制， 倍速控制等。
通过引导自设定键位坐标，避免按压琴键的偏移问题。
在线共享乐谱，有许多优质乐谱。
自动更新，及时修复 BUG，无需担心版本过时问题。
多语言支持。
...

使用

以下两种方式仅需选择一种

拷贝脚本（推荐）

在 Releases · kkevsekk1/AutoX 中下载 AutoX。

注意：请提前悉知设备架构选择 arm64-v8a 或 armeabi-v7a，否则选择 universal。

为 AutoX 开启无障碍服务和悬浮窗权限和存储权限。
在 AutoX 中新建一个脚本并粘贴以下代码并运行：

"ui";
"use strict";
const okhttp3 = Packages["okhttp3"];
(function(emitter) {
  const client = (new okhttp3.OkHttpClient.Builder())
    .connectTimeout(3, java.util.concurrent.TimeUnit.SECONDS)
    .writeTimeout(3, java.util.concurrent.TimeUnit.SECONDS)
    .readTimeout(3, java.util.concurrent.TimeUnit.SECONDS)
    .build();
  threads.start(function () {
    emitter.emit("evaluate", (function () {
      //Many sources 
      let sources = [
        "https://cdn.jsdelivr.net/gh/StageGuard/SkyAutoPlayerScript/source/SkyAutoplayer.js",
        "http://cdn.stagex.top:8090/StageGuard/SkyAutoPlayerScript/raw/master/source/SkyAutoplayer.js",
        "https://dl.skyautoplayerscript.stageguard.top/source/SkyAutoplayer.js",
        "https://raw.githubusercontent.com/StageGuard/SkyAutoPlayerScript/master/source/SkyAutoplayer.js"
      ];
      for (let i in sources) {
        try {
          let resp = client.newCall(
            (new okhttp3.Request.Builder()).url(sources[i]).build()
          ).execute();
          if (resp.code() == 200) return resp.body().string();
        } catch(e) {
          let err = "Failed on source " + sources[i] + " : " + e;
          console.log(err); toast(err);
        }
      }
      console.show();
      return null;
    }()));
  });
  emitter.on('evaluate', s => { if(s != null) eval(s); });
}(events.emitter(threads.currentThread())));

安装独立程序（仅 arm64-v8a 可用）

在 Releases · StageGuard/SkyAutoPlayerScript 中下载脚本独立打包程序，安装后即可使用。

首次启动时请同意程序申请的权限：无障碍服务和悬浮窗权限和存储权限。

注意：本程序申请的权限为 AutoX 打包程序自动控制，且仅申请使脚本运行的必要权限。

兼容性

在 AutoX 版本 6.3.6 中测试通过。

清除数据

SkyAutoPlayerScript 在使用过程中会产生本地数据存储，若想全部删除，请使用 AutoX 执行以下代码

storages.remove("StageGuard:SkyAutoPlayer:Config");
files.removeDir("/storage/emulated/0/Documents/SkyAutoPlayer/");

上传乐谱

SkyAutoplayerScript 可以从这个仓库中的 shared_sheets.json 读取在线共享乐谱列表并可以方便地下载和弹奏。

你可以通过以下两种方式的任意一种方式来让你自制或经过原作者授权转载的乐谱在这个列表显示：

1. Pull Request

你可以克隆这个仓库，将你的乐谱添加到 shared_sheets 文件夹中，并按照以下要求在 shared_sheets.json 中添加新的项目：

{
  //乐谱名称
  "name": "Vicetone - Nevada",
  //文件名
  "file": "Nevada.txt",
  //乐谱作者
  "author": "StageGuard",
  //乐谱简介
  "desc": "Nevada SkyStudio钢琴版。\n内包含<u>比较复杂的和弦</u>，不适合手弹(笑\n你可以在SkyStudio的练习模式试试[狗头]",
  //乐谱文件中的BPM
  "bpm": 497,
  //乐谱的键位数目(它是一个 15 键位乐谱还是 8 键位乐谱)
  "keyCount": 15,
  //乐谱文件中的音高
  "pitchLevel": 3,
  //键的数目
  //乐谱文件中数组 songNotes 的长度
  "noteCount": 1308,
  //你的社交链接
  //你可以添加多个
  "social": [
    {
      //社交平台名称代号，现在支持 github, twitter, douyin(tiktok) and coolapk
      "platform": "github",
      //社交平台名称
      "name": "GitHub",
      //社交连接
      "link": "https://github.com/StageGuard/"
    }
  ]
},

修改完成后，申请 Pull Request ，等待 merge 即可。

请注意：在申请Pull Request之前请确保你本地的仓库已同步至最新，以免出现意外问题！

2. 如果你不是很懂 Github...

只需要把乐谱发送到邮箱 beamiscool@qq.com 来交给我就行啦！别忘了附带乐谱简介！

注意!

请仔细阅读以下使用须知！

未充分测试，若遇到 BUG ，请酷安私信 @StageGuard 或新建 Issue 来反馈 BUG！
SkyAutoplayerScript 是完全免费且开源的软件/脚本(https://github.com/StageGuard/SkyAutoPlayerScript)，使用 SkyAutoplayerScript 盈利的同时请标注源项目链接。
共享乐谱不遵守 LGPL-2.1 协议，如您想在 SkyAutoPlayer 以外使用这些乐谱，请自行找乐谱作者授权！
本脚本仅可用作娱乐用途，请不要在正规场合使用本脚本(请自行体会"正规场合"是什么意思)，若因使用本脚本所出现了一些不友好的问题，与脚本作者 StageGuard 无关。
脚本只能给你一时满足感而不能使你进步，请适当使用，只有真正的技术才是王道，才能使你感到快乐。
本脚本只是一个"弹奏机"，并不内置曲谱，请在 GooglePlay 下载 SkyStudio 编谱。
本脚本不会增加解密乐谱功能，包括但不限于加密的 SkyStudio 乐谱，加密的 JS 等，也不接受加密乐谱的共享。

针对上述第2, 3条出现的问题：

关于脚本倒卖的问题: #1

耻辱柱

Gitee 用户嗨游圈(@vipssp)在未经乐谱上传者的同意下私自盗用 SkyAutoplayerScript 于 Gitee 的同步镜像到它的 Gitee 仓库。

在经过通知后仍未及时删除盗用的乐谱，在于一些乐谱原作者沟通后，决定将其挂在此 README.md 首部，以告示。

贡献

欢迎任何人贡献本项目，包括但不限于 Pull Request，Issue，New feature request 或者贡献翻译。

⚠️警告

CodeFactor 代码评估:

由于项目为单脚本文件，未将不同模块分离至文件，即所有功能均在一个文件实现；再加上我糟糕的代码技能，源码会非常难读。

贡献者