From ea392e0d60bcdbbde498080be12e7f4f93944b0a Mon Sep 17 00:00:00 2001
From: Harvey Zack <laozhaochaguan@gmail.com>
Date: Fri, 1 Aug 2025 09:57:50 +0800
Subject: [PATCH] feat: update version to 5.1.7 and add custom userAgent
 documentation

---
 CHANGELOG_CN.md                               |  2 +
 docs/compiled/artplayer-plugin-danmuku.esm.js |  2 +-
 docs/compiled/artplayer-plugin-danmuku.js     |  2 +-
 .../artplayer-plugin-danmuku.legacy.js        |  2 +-
 .../dist/artplayer-plugin-danmuku.esm.js      |  2 +-
 .../dist/artplayer-plugin-danmuku.js          |  2 +-
 .../dist/artplayer-plugin-danmuku.legacy.js   |  2 +-
 .../artplayer-plugin-danmuku/package.json     |  2 +-
 packages/artplayer-vitepress/docs/en/index.md | 38 ++++++++++++++++++-
 packages/artplayer-vitepress/docs/index.md    | 38 ++++++++++++++++++-
 10 files changed, 83 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG_CN.md b/CHANGELOG_CN.md
index 159f9789c..cd9cfaa0a 100644
--- a/CHANGELOG_CN.md
+++ b/CHANGELOG_CN.md
@@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [5.2.4] - 2025-08-01
+
 - 为所有包添加 `ESM` 版本如 `artplayer/dist/artplayer.esm.js`
 - 识别 `globalThis.CUSTOM_USER_AGENT` 全局变量，用于自定义 `navigator.userAgent`
 - 修复 `artplayer-plugin-danmuku` 初始化时 `mount` 参数缺失的错误
diff --git a/docs/compiled/artplayer-plugin-danmuku.esm.js b/docs/compiled/artplayer-plugin-danmuku.esm.js
index 949f2f507..6a8f453f2 100644
--- a/docs/compiled/artplayer-plugin-danmuku.esm.js
+++ b/docs/compiled/artplayer-plugin-danmuku.esm.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/docs/compiled/artplayer-plugin-danmuku.js b/docs/compiled/artplayer-plugin-danmuku.js
index ef47ca3a4..04e9e5b44 100644
--- a/docs/compiled/artplayer-plugin-danmuku.js
+++ b/docs/compiled/artplayer-plugin-danmuku.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/docs/compiled/artplayer-plugin-danmuku.legacy.js b/docs/compiled/artplayer-plugin-danmuku.legacy.js
index d26a49466..596a043d6 100644
--- a/docs/compiled/artplayer-plugin-danmuku.legacy.js
+++ b/docs/compiled/artplayer-plugin-danmuku.legacy.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.esm.js b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.esm.js
index 949f2f507..6a8f453f2 100644
--- a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.esm.js
+++ b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.esm.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js
index ef47ca3a4..04e9e5b44 100644
--- a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js
+++ b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.legacy.js b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.legacy.js
index d26a49466..596a043d6 100644
--- a/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.legacy.js
+++ b/packages/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.legacy.js
@@ -1,6 +1,6 @@
 
 /*!
- * artplayer-plugin-danmuku.js v5.1.6
+ * artplayer-plugin-danmuku.js v5.1.7
  * Github: https://github.com/zhw2590582/ArtPlayer
  * (c) 2017-2025 Harvey Zack
  * Released under the MIT License.
diff --git a/packages/artplayer-plugin-danmuku/package.json b/packages/artplayer-plugin-danmuku/package.json
index 6b20e2766..6c3f718cd 100644
--- a/packages/artplayer-plugin-danmuku/package.json
+++ b/packages/artplayer-plugin-danmuku/package.json
@@ -1,6 +1,6 @@
 {
     "license": "MIT",
-    "version": "5.1.6",
+    "version": "5.1.7",
     "name": "artplayer-plugin-danmuku",
     "description": "Danmuku plugin for ArtPlayer",
     "main": "dist/artplayer-plugin-danmuku.js",
diff --git a/packages/artplayer-vitepress/docs/en/index.md b/packages/artplayer-vitepress/docs/en/index.md
index 5fb8f77e9..bc6279f57 100644
--- a/packages/artplayer-vitepress/docs/en/index.md
+++ b/packages/artplayer-vitepress/docs/en/index.md
@@ -404,4 +404,40 @@ Starting from `5.2.4`, `artplayer` and all plugins will also provide an `ESM` ve
 </body>
 
 </html>
-```
\ No newline at end of file
+```
+
+## Custom userAgent
+
+Currently, the determination of mobile devices is not accurate. Sometimes, you may want to adjust the player UI by changing the `userAgent`. Therefore, starting in version `5.2.4`, we added a new `globalThis.CUSTOM_USER_AGENT` global variable.
+
+```html
+<html>
+    <head>
+        <title>ArtPlayer Demo</title>
+        <meta charset="UTF-8" />
+        <style>
+            .artplayer-app {
+                width: 400px;
+                height: 300px;
+            }
+        </style>
+    </head>
+    <body>
+        <div class="artplayer-app"></div>
+        <script>globalThis.CUSTOM_USER_AGENT = 'iphone'</script>
+        <script src="path/to/artplayer.js"></script>
+        <script>
+          const art = new Artplayer({
+              container: '.artplayer-app',
+              url: 'path/to/video.mp4',
+          });
+        </script>
+    </body>
+</html>
+```
+
+::: warning Warning
+
+You need to modify it before import the `Artplayer` for it to take effect
+
+:::
\ No newline at end of file
diff --git a/packages/artplayer-vitepress/docs/index.md b/packages/artplayer-vitepress/docs/index.md
index c6b5e99f0..19136944d 100644
--- a/packages/artplayer-vitepress/docs/index.md
+++ b/packages/artplayer-vitepress/docs/index.md
@@ -409,4 +409,40 @@ https://unpkg.com/artplayer/dist/artplayer.legacy.js
 </body>
 
 </html>
-```
\ No newline at end of file
+```
+
+## 自定义 userAgent
+
+目前对于是否移动设备的判断并不准确，有时候希望通过改变 `userAgent` 来调整播放器的UI, 所以在 `5.2.4` 开始新增了一个 `globalThis.CUSTOM_USER_AGENT` 全局变量。
+
+```html
+<html>
+    <head>
+        <title>ArtPlayer Demo</title>
+        <meta charset="UTF-8" />
+        <style>
+            .artplayer-app {
+                width: 400px;
+                height: 300px;
+            }
+        </style>
+    </head>
+    <body>
+        <div class="artplayer-app"></div>
+        <script>globalThis.CUSTOM_USER_AGENT = 'iphone'</script>
+        <script src="path/to/artplayer.js"></script>
+        <script>
+          const art = new Artplayer({
+              container: '.artplayer-app',
+              url: 'path/to/video.mp4',
+          });
+        </script>
+    </body>
+</html>
+```
+
+::: warning 提示
+
+你需要在引入 `Artplayer` 依赖前来修改它才会生效
+
+:::
\ No newline at end of file