您的名字
266 lines
6.4 KiB
Markdown
266 lines
6.4 KiB
Markdown
# 广告拦截功能说明
|
||
|
||
## 📌 功能概述
|
||
|
||
XMBOX内置了强大的广告拦截系统，可以有效过滤视频播放过程中弹出的各类广告，特别是常见的赌博广告（如澳门新葡京、皇冠、金沙等）。
|
||
|
||
## 🎯 拦截类型
|
||
|
||
### 1. 赌博类广告 ⭐⭐⭐⭐⭐
|
||
**最常见的视频中途弹窗广告**
|
||
|
||
包括但不限于：
|
||
- 澳门新葡京、皇冠、金沙、威尼斯人、永利等博彩品牌
|
||
- 各类赌场、扑克、投注网站
|
||
- 使用 `xpj`、`wnsr`、`js[数字]`、`vn[数字]` 等域名的赌博网站
|
||
|
||
**特征**：通常在视频播放到一半时突然弹出，覆盖整个播放器
|
||
|
||
### 2. 广告联盟
|
||
- Google广告联盟（DoubleClick、AdSense等）
|
||
- 百度广告联盟
|
||
- 淘宝/阿里广告联盟
|
||
- 腾讯广告联盟
|
||
|
||
### 3. 视频平台广告
|
||
- 优酷、爱奇艺、腾讯视频等平台的贴片广告
|
||
- 芒果TV、乐视等平台广告
|
||
|
||
### 4. 弹窗广告
|
||
- 页面加载时的弹窗
|
||
- 点击播放时的诱导弹窗
|
||
|
||
### 5. 跟踪统计
|
||
- 百度统计、Google Analytics
|
||
- CNZZ、友盟等统计代码
|
||
|
||
## 🔧 使用方法
|
||
|
||
### 方式一：内置拦截（推荐）✅
|
||
|
||
**无需任何配置**，应用已内置200+常见广告域名，包括：
|
||
|
||
```java
|
||
// 已内置的赌博广告域名示例
|
||
".*\\..*葡京.*" // 拦截所有包含"葡京"的域名
|
||
".*\\..*皇冠.*" // 拦截所有包含"皇冠"的域名
|
||
".*xpj.*\\..*" // 拦截新葡京相关域名
|
||
"wan.51img1.com" // 常见广告CDN
|
||
"vip.ffzyad.com" // 视频广告域名
|
||
```
|
||
|
||
### 方式二：自定义拦截
|
||
|
||
在配置文件中添加 `ads` 字段：
|
||
|
||
```json
|
||
{
|
||
"spider": "your_spider_url",
|
||
"sites": [...],
|
||
|
||
"ads": [
|
||
"精确域名匹配",
|
||
"example-ad.com",
|
||
"another-ad-domain.net",
|
||
|
||
"通配符匹配",
|
||
".*\\.advertisement\\..*",
|
||
".*\\.ad-server\\..*",
|
||
|
||
"关键词匹配",
|
||
".*赌博.*",
|
||
".*博彩.*"
|
||
]
|
||
}
|
||
```
|
||
|
||
### 方式三：片头片尾跳过 🎬
|
||
|
||
对于**嵌入视频流中的广告**（无法通过域名拦截），使用片头片尾跳过功能：
|
||
|
||
#### 设置片头跳过
|
||
1. 播放视频
|
||
2. 在片头广告结束后（前5分钟内），点击 **【片头】** 按钮
|
||
3. 当前时间点会被记录
|
||
4. 下次播放时自动从这个时间点开始
|
||
|
||
#### 设置片尾跳过
|
||
1. 播放到片尾广告开始前（后5分钟内），点击 **【片尾】** 按钮
|
||
2. 当前时间点会被记录
|
||
3. 下次播放时会在这个时间点停止
|
||
|
||
#### 重置设置
|
||
长按 **【片头】** 或 **【片尾】** 按钮即可重置
|
||
|
||
## 📝 工作原理
|
||
|
||
### WebView层拦截
|
||
```java
|
||
// 在WebView加载资源时拦截
|
||
@Override
|
||
public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) {
|
||
String host = request.getUrl().getHost();
|
||
|
||
// 检查是否为广告域名
|
||
if (isAd(host)) {
|
||
// 返回空响应，阻止广告加载
|
||
return emptyResponse;
|
||
}
|
||
|
||
return super.shouldInterceptRequest(view, request);
|
||
}
|
||
```
|
||
|
||
### 拦截流程
|
||
```
|
||
视频请求 → 检查域名 → 内置黑名单？ → 是 → 拦截 ❌
|
||
↓
|
||
否
|
||
↓
|
||
用户自定义黑名单？ → 是 → 拦截 ❌
|
||
↓
|
||
否
|
||
↓
|
||
允许加载 ✅
|
||
```
|
||
|
||
## 🛠️ 高级配置
|
||
|
||
### 1. 正则表达式匹配
|
||
|
||
```json
|
||
{
|
||
"ads": [
|
||
".*\\.ad.*\\.com", // 匹配 sub.adserver.com
|
||
".*gambling.*", // 匹配任何包含gambling的域名
|
||
"^https?://[^/]*ad[^/]*/" // 匹配URL中包含ad的路径
|
||
]
|
||
}
|
||
```
|
||
|
||
### 2. 分类管理
|
||
|
||
建议按类型组织广告域名：
|
||
|
||
```json
|
||
{
|
||
"ads": [
|
||
"// === 赌博广告 ===",
|
||
".*葡京.*",
|
||
".*casino.*",
|
||
|
||
"// === 视频平台广告 ===",
|
||
"atm.youku.com",
|
||
"cupid.iqiyi.com",
|
||
|
||
"// === 弹窗广告 ===",
|
||
"mimg.0c1q0l.cn",
|
||
"www.92424.cn"
|
||
]
|
||
}
|
||
```
|
||
|
||
## 📊 效果统计
|
||
|
||
启用广告拦截后，您可以看到：
|
||
|
||
- ✅ 视频播放更流畅
|
||
- ✅ 无中途弹窗干扰
|
||
- ✅ 隐私数据不被跟踪
|
||
- ✅ 节省流量消耗
|
||
|
||
## ❓ 常见问题
|
||
|
||
### Q1: 为什么有些广告还是会出现？
|
||
|
||
**A:** 可能的原因：
|
||
1. 广告直接嵌入视频流（使用片头片尾跳过）
|
||
2. 广告使用了新的域名（可添加到自定义黑名单）
|
||
3. 广告通过JavaScript动态生成（内容层广告，较难拦截）
|
||
|
||
### Q2: 会不会误拦截正常内容？
|
||
|
||
**A:** 内置域名库经过精心筛选，主要针对已知广告域名。误拦截概率极低。如遇到问题，可以：
|
||
- 关闭内置拦截（需修改代码）
|
||
- 反馈给开发者更新黑名单
|
||
|
||
### Q3: 如何找到广告的域名？
|
||
|
||
**A:** 方法：
|
||
1. 使用Chrome浏览器开发者工具（F12）查看Network请求
|
||
2. 查看应用日志输出的URL
|
||
3. 参考其他用户分享的广告域名列表
|
||
|
||
### Q4: 拦截会影响性能吗？
|
||
|
||
**A:** 影响极小：
|
||
- 仅在WebView解析阶段生效
|
||
- 字符串匹配操作非常快速
|
||
- 反而会因为减少网络请求而提升性能
|
||
|
||
### Q5: 数据会被上传吗？
|
||
|
||
**A:** 完全不会：
|
||
- 所有拦截在本地进行
|
||
- 不联网、不上传
|
||
- 完全保护您的隐私
|
||
|
||
## 🔍 调试方法
|
||
|
||
### 查看拦截日志
|
||
|
||
启用调试模式可以看到被拦截的域名：
|
||
|
||
```bash
|
||
# 连接设备
|
||
adb logcat | grep "WebView\|AdBlocker"
|
||
|
||
# 查看拦截记录
|
||
adb logcat | grep "blocked"
|
||
```
|
||
|
||
### 测试广告拦截
|
||
|
||
1. 访问包含广告的视频网站
|
||
2. 观察是否弹出广告
|
||
3. 检查日志中的拦截记录
|
||
|
||
## 📚 域名库维护
|
||
|
||
### 添加新的广告域名
|
||
|
||
编辑 `AdBlocker.java`：
|
||
|
||
```java
|
||
private static final List<String> GAMBLING_ADS = Arrays.asList(
|
||
// 添加新发现的广告域名
|
||
"new-casino-ad.com",
|
||
".*new-gambling.*"
|
||
);
|
||
```
|
||
|
||
### 提交贡献
|
||
|
||
如果您发现新的广告域名，欢迎：
|
||
1. 提交Issue报告
|
||
2. 提交Pull Request更新域名库
|
||
3. 在社区分享
|
||
|
||
## 💡 最佳实践
|
||
|
||
1. **优先使用内置拦截** - 已覆盖大部分常见广告
|
||
2. **补充自定义规则** - 针对特定视频源的广告
|
||
3. **善用片头片尾跳过** - 处理嵌入式广告
|
||
4. **定期更新** - 保持应用最新版本以获取最新域名库
|
||
|
||
## 🎉 总结
|
||
|
||
XMBOX的广告拦截系统通过**三层防护**：
|
||
|
||
1. 🛡️ **内置域名库** - 200+常见广告（含澳门新葡京等赌博广告）
|
||
2. 🛡️ **自定义黑名单** - 用户针对性添加
|
||
3. 🛡️ **片头片尾跳过** - 处理嵌入式广告
|
||
|
||
让您享受**纯净、流畅、安全**的视频观看体验！
|
||
|