### 一、场景与痛点

你在做监控平台、直播系统、视频回放，摄像头推的是 H.265 的 FLV 流。在 Chrome 上跑得好好的，结果客户说：

> "我们单位用的是 Firefox 和国产浏览器（360、奇安信、UOS），黑屏。"

查了一圈发现真相很残酷：

| 浏览器 | HEVC 硬解支持 |
| --- | --- |
| Chrome (Win/Mac) | ✅ 部分支持 |
| Chrome (Linux) | ❌ |
| Firefox (全平台) | ❌ |
| Safari 16+ | ✅ |
| 360 / QQ / 奇安信 | ❌ |
| UOS / 麒麟浏览器 | ❌ |
| Edge / Chromium | 同 Chrome |

市面上已有的方案：

1.  **服务端实时转码** H.265 → H.264 — 需要 GPU，增加成本，增加延迟
2.  **Easyplayer 方案等。但是他api，样式稀烂，并且带产品logo**

两条路都不想走。那有没有第三种方案？

### 二、解决方案：WebAssembly 软解

技术栈：

-   **西瓜播放器 xgplayer**（字节跳动开源）作为播放器壳
-   **libmedia** 项目提供的编译好的 FFmpeg wasm 解码模块
-   **软解框架**位于 `xgplayer-soft-decode` 包，包含资源加载、解码流水线、Canvas 渲染

整体架构：

```bash
流地址 → FLV/HLS 解析 → demux 分离音视频
                        ├── 音频 → 浏览器原生解码（走 MSE）
                        └── 视频 → wasm HEVC 解码 → Canvas 渲染
```

关键设计：**自动回退**。浏览器能硬解就走原生 MSE，不能硬解自动切 wasm 软解，开发者不需要写任何判断逻辑。

### 三、特性一览

| 特性 | 说明 |
| --- | --- |
| FLV + H.265 | ✅ 支持 |
| HLS + H.265 | ✅ 支持 |
| 无音频流 | ✅ 自动注入静音时钟轨道 |
| 硬解优先 | ✅ 自动检测，自动回退 |
| 强制软解 | ✅ `softDecode: true` |
| wasm 4 变体 | SIMD / Atomic / Baseline / 64 位自动选择 |
| 本地 wasm | ✅ 可自托管，不依赖 CDN |
| HTTP/HTTPS | 
✅ 均可（不可用 file://）
 |

### 四、使用步骤

#### 4.1 方式一：直接拷贝 UMD 文件

适合不想用 npm 的普通项目。

**第一步**：在 [GitHub Releases](https://github.com/bfzg/xgplayer "GitHub Releases") 下载 zip，或者从 demo 目录拷贝 `umd/` 文件夹到你的项目：

```bash
your-project/public/
  umd/
    xgplayer.min.js          ← 西瓜播放器核心
    xgplayer-soft-decode.min.js  ← 软解模块
    xgplayer-hls.min.js      ← HLS 插件
    xgplayer-flv.min.js      ← FLV 插件
    xgplayer.min.css         ← 播放器样式
  wasm/
    decode/
      hevc-simd.wasm         ← wasm 软解（可自托管或用 CDN）
      hevc-atomic.wasm
      hevc.wasm
      hevc-64.wasm
```

**第二步**：页面引入脚本（顺序不能错）：

```bash
<link rel="stylesheet" href="/umd/xgplayer.min.css">
<script src="/umd/xgplayer.min.js"></script>
<script src="/umd/xgplayer-soft-decode.min.js"></script>
<script src="/umd/xgplayer-hls.min.js"></script>
<script src="/umd/xgplayer-flv.min.js"></script>
```

**第三步**：创建播放器：

```bash
<div id="player" style="width:100%;height:480px"></div>
<script>
  var player = new Player({
    id: 'player',
    url: 'https://your-host/live/stream.flv',
    isLive: true,
    autoplay: true,
    autoplayMuted: true,
    plugins: [FlvPlayer],          // HLS 用 HlsPlayer
    softDecode: 'auto',            // 'auto' | true | false
    softDecodeOptions: {
      wasmBaseUrl: '/wasm'         // wasm 目录，不填则走 CDN
    }
  })
</script>
```

完成。

#### 4.2 方式二：从源码运行 Demo

```bash
git clone https://github.com/bfzg/xgplayer.git
cd xgplayer
yarn && yarn build:all
cd demo && bash start.sh
# 浏览器打开 http://127.0.0.1:8080/demo/index.html
```

### 五、配置项说明

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `softDecode` | `string|boolean` | `'auto'` | `'auto'` 自动回退 / `true` 强制软解 / `false` 关闭 |
| `softDecodeOptions.wasmBaseUrl` | `string` | CDN | wasm 目录，含 `decode/` 的那一层 |
| `softDecodeOptions.wasmVariant` | `string` | `'auto'` | 指定 wasm 变体：`simd` / `atomic` / `baseline` |
| `softDecodeOptions.renderer` | `string` | `'canvas'` | 渲染方式，目前仅支持 canvas |
| `onSoftDecodeFallback` | `function` | \- | 切软解时的回调 `function(info)` |

### 七、开源地址

**GitHub**：**[GitHub - bfzg/xgplayer: A HTML5 video player with a parser that saves traffic 西瓜播放器 支持 wasm h265 软解 · GitHub](https://github.com/bfzg/xgplayer "GitHub - bfzg/xgplayer: A HTML5 video player with a parser that saves traffic 西瓜播放器 支持 wasm h265 软解 · GitHub")**

-   完整源码，基于 xgplayer 二次开发
-   演示 demo 一键运行
-   MIT 协议 + wasm 解码（LGPL）
-   欢迎 Star / Issue / PR

一、场景与痛点 你在做监控平台、直播系统、视频回放，摄像头推的是 H.265 的 FLV 流。在 Chrome 上跑得好好的，结果客户说： "我们单位用的是 Firefox 和国产浏览器（360、奇安信、UOS），黑屏。" 查了一圈发现真相很残酷： | 浏览器 | HEVC 硬解支持 | | --- | --- | | Chrome (Win/Mac) | ✅ 部分支持 | | Chrome (L

西瓜播放器 xgplayer 支持 H.265 软解：FLV/HLS 在 Firefox、国产浏览器下也能播了

音视频

开发工具

前端

基于西瓜播放器与FFmpeg wasm技术，实现H.265 FLV流在Firefox、360、UOS等浏览器上的WebAssembly软解，支持硬解自动回退，无需服务端转码，自托管wasm可降低延迟与成本，提供UMD与源码双部署方式。

WebAssembly

GitHub

Linux

HTML5

CDN免费试用


4核4G3M云服务器 新用户低至38元/年！

9.9元起，最快1天搭建自有直播平台


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

西瓜播放器 xgplayer 支持 H.265 软解：FLV/HLS 在 Firefox、国产浏览器下也能播了-腾讯云开发者社区-腾讯云

西瓜播放器 xgplayer 支持 H.265 软解：FLV/HLS 在 Firefox、国产浏览器下也能播了

西瓜播放器 xgplayer 支持 H.265 软解：FLV/HLS 在 Firefox、国产浏览器下也能播了

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐