libde265.js 技术文档

1. 安装指南

1.1 环境准备

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：Linux（目前仅在Linux上测试）
• 浏览器：Google Chrome 33+、Firefox 28+、IE 11+、Opera 20+、Safari 7+（在OSX Mavericks上）
• 工具链：Emscripten

1.2 安装步骤

1. 安装Emscripten

   首先，您需要安装Emscripten。请按照以下步骤操作：

   • 下载并安装Emscripten：

     git clone https://github.com/emscripten-core/emsdk.git
     cd emsdk
     ./emsdk install latest
     ./emsdk activate latest
     source ./emsdk_env.sh
     

   • 将Emscripten添加到您的PATH中：

     export PATH=$PATH:$EMSDK/upstream/emscripten
     

2. 构建libde265.js

   进入项目目录并执行构建脚本：

   cd libde265.js
   ./build.sh
   

   构建脚本将自动下载并编译libde265，生成libde265.js文件。

3. 检查LLVM版本

   如果您的默认LLVM版本低于3.2，您可能需要安装llvm-3.2（或更新版本），并设置环境变量LLVM_ADD_VERSION：

   export LLVM_ADD_VERSION=3.2
   

2. 项目的使用说明

2.1 基本使用

libde265.js是一个纯JavaScript的HEVC/H.265视频解码库。您可以在现代浏览器中使用它来解码HEVC/H.265视频流。

2.2 示例代码

项目中包含一个简单的示例，位于demo文件夹中。您可以通过以下方式运行示例：

1. 打开demo文件夹中的HTML文件。
2. 在浏览器中打开该文件，查看示例效果。

您也可以访问在线示例来查看运行效果。

3. 项目API使用文档

3.1 初始化

var decoder = new libde265.Decoder();

3.2 解码视频流

decoder.decode(videoStream, function(frame) {
    // 处理解码后的帧
});

3.3 释放资源

decoder.release();

4. 项目安装方式

4.1 通过GitHub克隆项目

git clone https://github.com/strukturag/libde265.js.git

4.2 通过npm安装

npm install libde265.js

4.3 通过CDN引入

<script src="https://cdn.jsdelivr.net/npm/libde265.js@latest/dist/libde265.min.js"></script>

---

通过以上步骤，您可以成功安装并使用libde265.js进行HEVC/H.265视频解码。如果您在使用过程中遇到任何问题，请参考项目的GitHub页面获取更多帮助。