公云存储

Appearance

在线浏览&编辑 ​

嵌入网页式应用

嵌入网页式应用是 公云存储 内置的一种应用类型，您只需要提供一个网页的 URL 即可。公云存储 会将文件的相关信息和临时下载 URL 通过 Query 参数传递给网页。

公云存储 会通过文件的扩展名自动选择预览器。为此我们内置了多种文件格式的预览器，包括视频、图片、音频、代码、文本、Office 文档等。

本章节将介绍文档预览/编辑及其使用方式。

音乐播放器 ​

公云存储 内置了音乐播放器应用，其所支持的格式取决于浏览器。

音乐播放器的某些特性可能依赖于其他功能：

  • 当文件缩略图存在时，会作为专辑封面和模糊背景展示。
  • 当文件元信息中存在歌曲名、专辑、艺术家时，会优先展示；否则会展示文件名。

ePub 阅读器 ​

支持 ePub 文件电子书的阅读，阅读进度会保留在浏览器。

Google Docs / Microsoft Office 在线阅读 ​

公云存储 内置两种自定义应用的实例，分别是 Google 和 Microsoft 提供的公共文档的只读预览服务。

DANGER

如果需要使用这两种公共服务，需要预览的文件大小、格式符合预览服务的要求。比如 Microsoft 的预览服务要求文件大小不超过 10MB。

Office三大件 ​

公云存储除了支持调用Google Docs / Microsoft Office进行在线预览外，还对 Office 文档预览器提供了较高的扩展性。我们通过对WOPI 应用内置集成，将 Office 文档预览器对接并使用非常强大的第三方预览/编辑器，其自主定义可被预览/编辑的文件扩展名，为公云存储提供了极高的文档预览/编辑可选性。

INFO

Office三大件的使用方式基本上与本地自己设备编辑无差！

Word(文档) ​

经测试目前只支持编辑docx格式的word文档至于其他格式的可以自行测试，只要在线直接打开word文档有出现如下类似顶部工具栏那就是支持此种格式的word文档。

Excle(电子表格) ​

基本上与word文档编辑类似其本质和本地在线编辑无差，并且只要是直接在线打开后其可以在顶部出现相关工具栏那就是此种excle格式的电子表格支持在线编辑反之依然。

ppt(幻灯片) ​

基本上与word文档编辑类似其本质和本地在线编辑无差，相关效果如下图所示。

普通文本 ​

txt(记事本) ​

其默认将其使用word文档仅限打开后j'进行相关编辑操作与word一样也可以对其增添批准等。

PDF 阅读器 ​

基于 PDF.js 的 PDF 阅读器，支持 PDF 文件的阅读和标注，目前标注信息无法保存。

视频播放器 ​

公云存储 内置了视频播放器应用，其所支持的格式取决于浏览器，除此之外还支持 m3u8 播放列表。

外挂字幕 ​

支持 ass, srt, vtt 三种格式，当视频文件目录下存在同名的字幕文件时会自动加载，你也可以手动选择。

DANGER

字幕支持存在下列限制：

  • 无法加载视频内嵌字幕；
  • ASS 字幕的样式会丢失

章节 ​

当文件媒体信息中存在章节信息时，会在进度条中展示：

要使用此功能，你需要配置 FFprobe 媒体信息提取器，请参考 媒体信息提取。

m3u8 ​

视频播放器通过 hls.js 支持 m3u8 播放列表，可用于视频清晰度切片、直播等场景。

当 m3u8 文件中使用相对或绝对路径引用切片、播放列表等文件时，公云存储 会在播放时自动转换为请求相对于 m3u8 文件的 URL，请确保这些切片文件也上传到了 公云存储，并存放在正确的目录下。

案例 通过 FFMpeg 创建多种清晰度的加密视频切片，并上传到 公云存储 播放。

  1. 以Linux/类Unix为例。

  2. 准备原始视频 exmaple.mp4；

  3. 生成加密密钥：

    openssl rand 16 > enc.key

  4. 将 enc.key 上传到你的 公云存储 站点，并获取直链（也可以使用其他服务）。

  5. 创建一个 enc.keyinfo 的文件，第一行为刚才获取到的密钥直链，第二行为 enc.key 的本地路径，比如：

    http://pan.gongyun.org/f/gVVUW/enc.key
enc.key

  6. 使用 FFMpeg 创建多种清晰度的加密视频切片：

    ffmpeg -y -i example.mp4 -preset slow -g 48 -sc_threshold 0 -map 0:0 -map 0:1 -map 0:0 -map 0:1 -map 0:0 -map 0:1 -map 0:0 -map 0:1 -map 0:0 -map 0:1 -map 0:0 -map 0:1 -s:v:0 "1920*1080" -b:v:0 1800k -s:v:1 "1280*720" -b:v:1 1200k -s:v:2 "858*480" -b:v:2 750k -s:v:3 "630*360" -b:v:3 550k -s:v:4 "426*240" -b:v:4 400k -s:v:5 "256*144" -b:v:5 200k -c:a copy -var_stream_map "v:0,a:0,name:1080p v:1,a:1,name:720p v:2,a:2,name:480p v:3,a:3,name:360p v:4,a:4,name:240p v:5,a:5,name:144p" -master_pl_name master.m3u8 -f hls -hls_time 10 -hls_key_info_file enc.keyinfo -hls_playlist_type vod -hls_list_size 0 -hls_segment_filename "v%v/segment%d.ts" v%v/index.m3u8

  7. 将 master.m3u8 和所有切片目录文件上传到你的 公云存储 站点，请保留文件目录结构。你可以使用 目录上传 功能上传。

播放时，公云存储 会自动将 master.m3u8 中的相对路径切片 URL 替换为实际的切片文件的临时 Blob URL，并使用 enc.keyinfo 中的密钥解密切片文件。

Markdown 编辑器 ​

支持 Markdown 文件的编辑和预览。当文件内容不合法时，预览模式解析可能会失败，请切换到源代码模式查看。

图片查看器 ​

图片查看器支持图像的预览和编辑：

公云存储 将通过 媒体信息提取 功能获取图片的 EXIF 信息，并展示在图片查看器中。

Draw.io ​

支持使用 Draw.io 在线编辑图表或白板，支持多人协作。

默认情况下会使用 diagrams.net 的在线服务

文本编辑器 ​

支持使用 Monaco 在线编辑器编辑代码，支持多种语言高亮和编码切换。

DANGER

无论你选择使用何种编码打开，或者文件原始编码如何，文件都会使用 UTF-8 编码保存。

Photopea ​

使用 Photopea 在线编辑图片、PSD 等文件。