我的第一个油猴脚本
Tampermonkey 中文名俗称油猴，是一款免费的浏览器插件，目前最为流行的用户脚本管理器，用户可以通过油猴添加和使用脚本，而脚本是一种可以修改网页 JavaScript 的程序。通过这些脚本，可以实现视频解析、音乐下载、网盘直连解析、豆瓣资源下载、百度文库增强、屏蔽网站广告等功能。总之，通过油猴，我们可以实现很多想象不到的强大功能，而这些功能的背后就是依托庞大的脚本市场，如 greasyfork：https://greasyfork.org/zh-CN，我编写的脚本也是发布在这上面。
1、契机
从我接触到浏览器插件就用上了油猴，也算是打开了新世界的大门一样，接触了各式各样的脚本，比如：网页 vip 视频解析、百度网盘直链下载、百度文库复制、csdn 免登录复制、网页去广告、刷网课脚本等等，给我的上网冲浪生活带来了很多的便利，greasyfork 上的脚本基本上都能满足我的需求，而最近学校开了网课，网课每次看完之后就暂停了，要手动点下一节，这就产生了需求，而恰好 greasyfork 上没有这样的脚本，于是萌生了自己实现这样一个脚本的想法。
2、初步构思
- 在课程列表界面，自动检测没有完成的课程，点进去观看
- 课程视频自动播放且静音，开启视频倍速播放
- 检测视频的完成度，当完成度大于 95 则跳转至下一单元
- 直到所有课程都观看完毕
3、技术
需求实现实质就是一些逻辑判断，获取到指定的元素的值，然后做 if 判断以及页面跳转
- 原生 js 的 document 对象，获取指定的 dom 元素
- jQuery 方便获取 dom 节点
- 油猴提供的 API，GM_getValue 根据 key 获取 value、GM_setValue 设置 key-value 对、unsafeWindow 是油猴提供的沙盒环境，在 unsafeWindow 环境下，可以使用油猴提供的强大函数
4、脚本开发
在油猴插件的脚本管理界面创建新的脚本即可。我是用在 vscode 中写 js 代码，再复制到油猴中保存，然后在浏览器调试。这样挺不方便的，也没有去研究更高效的办法。
因为我对 js 也只是一知半解，再加上也没有那么多时间去研究，只以实现功能为准，没有去追求代码的优雅。
代码写的比较暴力，用了很多计时器。
5、脚本代码
// ==UserScript==
// @name scnu华南师范大学网课脚本
// @namespace http://tampermonkey.net/
// @version 1.2
// @description scnu 华南师范大学 长江雨课堂 网课自动化脚本
// @AuThor hqzqaq
// @Icon https://statics.scnu.edu.cn/statics/images/favicon.ico
// @grant GM_getValue
// @grant GM_setValue
// @grant unsafeWindow
// @match https://scnuyjs.yuketang.cn/pro/*
// @run-at document-end
// @license MIT
// @require https://cdn.bootcss.com/jquery/1.10.2/jquery.min.js
// ==/UserScript==
(function () {
"use strict";
// 多长时间刷新一下页面，单位 分钟
const reloadTime = 10;
// 视频播放速率,可选值 [1,1.25,1.5,2],默认为二倍速
const rate = 2;
window.onload = function () {
// 网课页面跳转
function getElTooltipItemList() {
return document.getElementsByClassName("el-tooltip leaf-detail");
}
function getElTooltipList() {
return document.getElementsByClassName("el-tooltip f12 item");
}
// 静音
function claim() {
$(
"#video-box > div > xt-wrap > xt-controls > xt-inner > xt-volumebutton > xt-icon"
).click();
}
function fun(className, selector)
{
var mousemove = document.createEvent("MouseEvent");
mousemove.initMouseEvent("mousemove", true, true, unsafeWindow, 0, 10, 10, 10, 10, 0, 0, 0, 0, 0, null);
document.getElementsByClassName(className)[0].dispatchEvent(mousemove);
document.querySelector(selector).click();
}
// 加速
function speed() {
let keyt = '';
if(rate === 2 || rate === 1){
keyt = "[keyt='" + rate + ".00']"
}else{
keyt = "[keyt='" + rate + "']"
}
fun("xt_video_player_speed", keyt);
}
const getElementInterval = setInterval(function () {
const elTooltipList = getElTooltipList();
const elTooltipItemList = getElTooltipItemList();
if (elTooltipList) {
for (let index = 0; index < elTooltipList.length; index++) {
const element = elTooltipList[index];
const textContent = element.textContent;
//const textContent = ''
if (textContent === "未开始" || textContent === "未读") {
// 判断是否是习题
if(elTooltipItemList[index].innerText.indexOf('习题')!= -1){
continue;
}
// 判断是否已过学习时间
if (elTooltipItemList[index].children[1].children[0].innerText.indexOf("已过") != -1) {
continue;
}
window.clearInterval(getElementInterval);
GM_setValue("rowUrl", window.location.href.toString());
// 网课页面跳转
elTooltipItemList[index].click();
window.close();
break;
}
}
}
}, 1000);
let video;
const videoPlay = setInterval(function () {
// 获取播放器
video = document.getElementsByClassName("xt_video_player")[0];
if (!video) {
return;
}
setTimeout(function () {
// 视频开始5s之后再开启倍速
speed()
},5000);
claim();
window.clearInterval(videoPlay);
}, 500);
// 是否播放完成的检测
const playTimeOut = setInterval(function () {
if (!video) {
return;
}
video.play();
// 没有静音
if (video.volume != 0) {
claim();
}
const completeness = $(
"#app > div.app-wrapper > div.wrap > div.viewContainer.heightAbsolutely > div > div.video-wrap > div > div > section.title > div.title-fr > div > div > span"
);
if (!completeness) {
return;
}
if (typeof completeness[0] == "undefined") {
return;
}
const videoText = completeness[0].innerHTML
if (videoText) {
let str = videoText.toString();
const succ = str.substring(4, str.length - 1);
const succNum = parseInt(succ);
if (succ >= 95) {
const url = GM_getValue("rowUrl");
if(url){
window.clearInterval(playTimeOut);
window.location.replace(url);
}
}
}
}, 1000);
// 是否为阅读类型
const readInterval = setInterval(function () {
const read = $(
"#app > div.app-wrapper > div.wrap > div.viewContainer.heightAbsolutely > div > div.graph-wrap > div > div > section.title > div.title-fr > div > div"
);
if(!read){
return
}
if (typeof read[0] == "undefined") {
return;
}
const readText = read[0].innerHTML
if(readText){
if(readText.toString() === '已读'){
window.clearInterval(readInterval);
window.location.replace(GM_getValue("rowUrl"));
}
}
}, 1000);
// 为了防止页面假死，定时刷新一下页面
setTimeout(function () {
// 如果保存了课程列表路径就回退的课程列表页面
if(GM_getValue("rowUrl")){
window.location.replace(GM_getValue("rowUrl"));
}
location.reload()
},reloadTime * 60 * 1000);
};
})();
代码比较简单，简单的逻辑判断，最难的一个是视频倍速播放，这个 video 倍速播放是锁住的，调整倍速播放的属性是无效的，我就想直接触发它提供的二倍速也行，没想到这个也很困难，视频倍速播放的按钮，首先需要触发鼠标悬浮才有效，这就无法实现自动化的效果了。因为我对 js 的不熟悉，在网上也没有找到解决办法，尝试了各种办法都没有效果，本来一天就能弄完，为了这一个功能，又搭进去好几天\~\~\~，最后是想到去读 greasfork 上其他人实现这种功能的代码，没想到还真让我找到了，就是下面这一段珍贵的代码：
function fun(className, selector)
{
var mousemove = document.createEvent("MouseEvent");
mousemove.initMouseEvent("mousemove", true, true, unsafeWindow, 0, 10, 10, 10, 10, 0, 0, 0, 0, 0, null);
document.getElementsByClassName(className)[0].dispatchEvent(mousemove);
document.querySelector(selector).click();
}
先触发 dom 元素的 mousemove 事件
之前在网上也有看到过类似的描述，只是我不知道这个 mousemove.initMouseEvent(）怎么传参，再加上控制台报错，我就觉得这种方法不行，没想到也是解决办法是远在天边，近在眼前，不过好歹绕回来了。
6、注解介绍
代码的前面被 \==UserScript\== 包裹的注释，包含了一些注解，定义了脚本的一些元信息，接下来介绍几个常用的注解，更多的注解信息可以访问官方文档：https://www.tampermonkey.net/documentation.php。
- @name 定义脚本的名字
- @version 定义脚本的版本，在有代码更新的时候，需要改变版本的值，这样才能将代码推送给用户
- @description 脚本的描述
- @author 作者名字
- @icon 脚本的图标，可以是 url 地址，也可以是图片的 base64 编码
- @grant 获取权限，使用它可以获取油猴提供的 API
- @match 脚本生效的网址匹配，只有符合匹配规则的网址，才会执行脚本
- @run-at 脚本代码执行的时间，有好几个值，这里我用的是 document-end，即当所有的 dom 元素加载完毕之后再执行代码
- @license 开源许可证，这里我用的是 MIT，即所有人都可查看和修改代码
- @require 引入外部的 js，这里我引入了 jQuery
7、脚本的发布
前往 https://greasyfork.org/zh-CN 网址，登录，点击自己的头像即可发布自己编写的脚本。
填入脚本源码和脚本使用说明即可。
8、脚本使用
8.1、功能实现
目前已实现：
- 当进入课程界面，查找未开始和已经有完成度的课程和未读的材料，自动看视频，直到所有视频看完为止
- 视频界面，自动播放视频、静音、5秒之后默认开启二倍速
未实现：
- 答题，所有习题都会跳过，需要手动答题
只是做了些自动化的处理，理论上是不会有风险的（当然只是理论上，自行考虑 \^_\^）
8.2、使用
本脚本只适用于华南师范大学长江雨课堂
8.3、安装油猴
以edge浏览器为例，在扩展商店搜索tampermonkey,安装油猴插件
8.4、安装脚本
在 greasyfork（https://greasyfork.org/zh-CN） 网站，搜索scnu华南师范大学网课脚本关键字，安装脚本
8.5、脚本运行
前往 scnu 华南师范大学 长江雨课堂（https://scnuyjs.yuketang.cn/pro/portal/home/），登录，进入课程界面，即可开始刷课。
注意：edge 浏览器需要允许网站弹窗(注意地址栏的提示)脚本才能执行跳转，这个很关键，不然脚本无法正常执行。
8.6、参数调整
总共有两个参数可以调整
- 一个是页面刷新的时间，防止网络不好或者其它原因造成页面假死，默认为10分钟。
- 一个是视频倍速的速率，有四个值，1、1.25、1.5、2；默认为 2
可自己在代码编辑进行修改
[复制链接]
发表于 2022-11-5 23:35
