|
1 | 1 | # PDPlayerKit (JavaScript Library)
|
2 | 2 |
|
3 |
| -> PDPlayerKit 是一個模組化的 JavaScript 播放器,支持嵌入式 HTML5、YouTube 和 Vimeo 播放器,具備高度自定義的控制面板、風格主題,並支援多媒體格式。 |
| 3 | +> 模組化 JavaScript 媒體播放器<br> |
| 4 | +> 支援 HTML5、YouTube、Vimeo,提供靈活主題與完整控制面板。 |
4 | 5 |
|
5 |
| -  <br> |
6 |
| -[](https://github.com/pardnchiu/PDPlayerKit) [](https://www.npmjs.com/package/pdplayerkit)  |
| 6 | + |
| 7 | + |
| 8 | +<br> |
| 9 | +[](https://github.com/pardnchiu/PDPlayerKit) |
| 10 | +[](https://www.npmjs.com/package/pdplayerkit) |
| 11 | +[](https://www.jsdelivr.com/package/npm/pdplayerkit) |
7 | 12 |
|
8 | 13 | ## 特點
|
9 | 14 |
|
10 |
| -- 多媒體支持:支持 HTML5 影片、YouTube 和 Vimeo 播放,音訊播放功能也已新增。 |
11 |
| -- 自定義控制面板:包括播放、暫停、音量調節、播放速率調整等功能,並提供多種風格主題選擇。 |
12 |
| -- 多風格主題:內建多種預設風格,使用者可依據需求自由切換(如 Minimal、Classic、Retro、Simple 等)。 |
13 |
| -- 多種版本支持:提供 ESM 和普通版本,方便用於不同開發環境。 |
14 |
| -- 無依賴:已排除 PDRenderKit 的依賴。 |
15 |
| -- 授權從 GPL 3.0 改為 MIT |
16 |
| -- 使用 [Google Icons](https://fonts.google.com/icons) 圖示黨做按鈕。 |
17 |
| -- 使用 [pixabay.com](https://pixabay.com/videos/) 影音資源做範例。 |
18 |
| -- 可在 [此處](https://pardnchiu.github.io/PDPlayerKit) 預覽。 |
| 15 | +### 多媒體播放 |
| 16 | +- 支援多類型:可播放 **HTML5 影片 / 音訊**、**YouTube** 與 **Vimeo**。 |
| 17 | +- 兼容桌面與行動設備,支持 `playsinline` 和 **全螢幕模式** 切換。 |
19 | 18 |
|
20 |
| -## 安裝方式 |
| 19 | +### 高度自定義控制面板 |
| 20 | +- 自由定制按鈕:**播放速率調整**、**音量控制**、**進度條** 等功能按需配置。 |
| 21 | +- 提供多種內建主題: (如 Minimal、Classic、Retro、Simple),方便自由選擇。 |
21 | 22 |
|
22 |
| -- **從 npm 安裝** |
23 |
| - ```bash |
24 |
| - npm i pdplayerkit |
25 |
| - ``` |
| 23 | +### 輕量與無依賴 |
| 24 | +- 基於 **原生 API** 和 **YouTube / Vimeo API**,無需額外庫,開箱即用。 |
| 25 | +- 完全移除 **PDRenderKit** 的依賴,減少耦合,提升使用便捷性。 |
| 26 | +- 文件體積小於 數 KB,即使在行動設備上也能高效運行。 |
| 27 | + |
| 28 | +### 全面的事件監聽 |
| 29 | +- 支持多種事件監聽: (如 ready、playing、pause、end),方便深度擴展。 |
26 | 30 |
|
27 |
| -- **從 CDN 引入** |
28 |
| - - **引入 `PDPlayerKit` 套件** |
29 |
| - ```html |
30 |
| - <script src="https://cdn.jsdelivr.net/npm/pdplayerkit@latest/dist/PDPlayerKit.js"></script> |
31 |
| - ``` |
32 |
| - - **Module 版本** |
33 |
| - ```javascript |
34 |
| - import { player as PDPlayer } from "https://cdn.jsdelivr.net/npm/pdplayerkit@latest/dist/PDPlayerKit.module.js"; |
35 |
| - ``` |
| 31 | +### 多版本支持 |
| 32 | +- 提供 **ESM (ECMAScript Module)** 與 **一般版本**,適用於多種開發環境,靈活集成。 |
36 | 33 |
|
37 |
| -## 使用方法 |
| 34 | +### 更直觀的控制按鈕 |
| 35 | +- 按鈕圖示使用 [Google Icons](https://fonts.google.com/icons),清晰、現代,適配各類主題風格。 |
38 | 36 |
|
| 37 | +### 友善授權 |
| 38 | +- 授權從 **GPL 3.0** 調整為 **MIT**,方便自由使用與修改,適應更多商業或個人項目。 |
| 39 | + |
| 40 | +## 安裝方式 |
| 41 | + |
| 42 | +### 從 npm 安裝 |
| 43 | +```bash |
| 44 | +npm i pdplayerkit |
| 45 | +``` |
| 46 | + |
| 47 | +### 從 CDN 引入 |
| 48 | +- **引入 `PDPlayerKit` 套件** |
| 49 | + ```html |
| 50 | + <script src="https://cdn.jsdelivr.net/npm/pdplayerkit@latest/dist/PDPlayerKit.js"></script> |
| 51 | + ``` |
| 52 | +- **Module 版本** |
| 53 | + ```javascript |
| 54 | + import { player as PDPlayer } from "https://cdn.jsdelivr.net/npm/pdplayerkit@latest/dist/PDPlayerKit.module.js"; |
| 55 | + ``` |
39 | 56 | - **初始化 `editor` 和 `viewer`**
|
40 | 57 | ```Javascript
|
41 | 58 | const dom = new PDPlayer({
|
|
0 commit comments