Skip to content

Commit a63fed0

Browse files
committed
chore: remove docs submodule and convert to regular directory
1 parent 8fe8cd8 commit a63fed0

36 files changed

Lines changed: 2947 additions & 1 deletion

docs

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2023 Mintlify
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

docs/advanced/media-server.mdx

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
title: '媒体服务器'
3+
description: '了解 EchoPlayer 内置的媒体服务器如何增强视频兼容性和播放体验'
4+
---
5+
6+
为了提供更广泛的视频格式支持和更流畅的播放体验,EchoPlayer 内置了一个强大的**媒体服务器**功能。本篇文档将详细解释它的工作原理、优势以及常见问题。
7+
8+
## 什么是媒体服务器?
9+
10+
媒体服务器是 EchoPlayer 的一个内置组件,它可以在您的电脑上实时地将不兼容的视频格式转换为标准的 **HLS (HTTP Live Streaming)** 格式。
11+
12+
这个过程完全在本地进行,不会消耗任何网络流量。您可以把它想象成一个即时的、智能的视频格式转换器,确保任何音视频都能在 EchoPlayer 中播放。
13+
14+
## 为什么需要它?
15+
16+
虽然 EchoPlayer 支持大多数主流视频格式,但某些特定的视频编码(如 H.265/HEVC)或封装格式(如某些 MKV 文件)在标准的播放器中存在一些原生限制:
17+
18+
- **精确寻道困难**:在视频进度条上拖拽时,可能无法准确定位到您想要的时间点,或者响应很慢。
19+
- **播放卡顿**:在播放高码率或特殊编码的视频时,可能会出现卡顿或掉帧。
20+
- **只有画面没有声音**:部分视频的音轨不支持,导致播放时只能看到画面而听不到声音。
21+
- **兼容性问题**:某些设备或平台可能无法原生解码特定的视频流。
22+
23+
媒体服务器通过将这些视频转换为标准化的 HLS 流,彻底解决了以上问题,为您带来如丝般顺滑的播放和寻道体验。
24+
25+
## 何时会使用媒体服务器?
26+
27+
您不需要手动开启或关闭媒体服务器,EchoPlayer 会智能地为您决策。
28+
29+
当您尝试播放一个 EchoPlayer 认为可能存在兼容性问题的视频文件时,系统会自动弹出一个提示框:
30+
31+
<Frame caption="媒体服务器推荐提示">
32+
<img src="/images/media-server-prompt.png" alt="媒体服务器推荐提示" />
33+
</Frame>
34+
35+
<CardGroup cols={2}>
36+
<Card title="立即安装" icon="check-circle">
37+
- EchoPlayer 将在后台启动媒体服务器进行实时转码,**这是推荐选项**
38+
</Card>
39+
<Card title="稍后再说" icon="circle-x">
40+
- EchoPlayer 将尝试直接播放原始文件,您可能会遇到前面提到的只有画面无声音或播放卡顿等问题。
41+
</Card>
42+
</CardGroup>
43+
44+
## 媒体服务器的优势
45+
46+
<AccordionGroup>
47+
<Accordion title="极致的播放流畅度">
48+
通过 HLS 协议,即使是高码率的 4K 视频,也能实现流畅播放和即时响应的进度拖拽。
49+
</Accordion>
50+
<Accordion title="更广泛的格式支持">
51+
解锁对 H.265 (HEVC) 等现代视频编码的完美支持,让您无需预先转换视频格式。
52+
</Accordion>
53+
<Accordion title="精确的逐句跳转">
54+
对于语言学习至关重要的“上一句/下一句”跳转功能,在 HLS 模式下将变得更加精准和可靠。
55+
</Accordion>
56+
<Accordion title="完全本地化处理">
57+
所有转码过程都在您的设备上完成,保护您的隐私,且不产生任何互联网数据消耗。
58+
</Accordion>
59+
</AccordionGroup>
60+
61+
## 常见问题 (FAQ)
62+
63+
<AccordionGroup>
64+
<Accordion title="使用媒体服务器会上传我的文件吗?">
65+
**绝对不会**。媒体服务器是一个完全在您本地计算机上运行的程序。您的任何文件都不会被上传到网络。
66+
</Accordion>
67+
<Accordion title="这个过程会占用很多电脑性能吗?">
68+
媒体服务器在工作时会占用一定的 CPU
69+
资源来进行视频转码。在大多数现代计算机上,这个过程都经过了优化,不会对您的正常使用造成显著影响。如果您在播放时遇到性能问题,可以尝试关闭其他占用资源的程序。
70+
</Accordion>
71+
<Accordion title="转码会产生很多临时文件吗?">
72+
是的,媒体服务器会生成一些临时的视频切片文件(HLS
73+
segments)并将其存储在应用的缓存目录中。不过您无需担心,这些缓存文件会在您关闭 EchoPlayer
74+
或播放新视频时**自动清理**,不会永久占用您的硬盘空间。
75+
</Accordion>
76+
<Accordion title="所有视频都需要使用媒体服务器吗?">
77+
**不需要**。只有当 EchoPlayer
78+
检测到视频可能存在兼容性或播放性能问题时,才会向您推荐使用。对于常见的 MP4 (H.264)
79+
等文件,将继续使用高效的原生播放模式。
80+
</Accordion>
81+
</AccordionGroup>
82+
83+
## 下一步
84+
85+
<CardGroup cols={2}>
86+
<Card title="播放控制" icon="play-circle" href="/player/playback-controls">
87+
深入了解播放器的各项控制功能
88+
</Card>
89+
<Card title="支持的格式" icon="file-video" href="/#支持的格式">
90+
查看 EchoPlayer 支持的所有视频和字幕格式
91+
</Card>
92+
</CardGroup>

0 commit comments

Comments
 (0)