【p-camera-h5】一款开箱即用的H5相机插件，支持拍照、录像、动态水印与样式高度定制化。

news2025/2/24 13:39:55

【开源推荐】p-camera-h5：一款轻量级H5相机插件开发实践

一、插件背景

在Web开发中，原生摄像头功能的集成往往面临以下痛点：

浏览器兼容性问题
视频流与水印叠加实现复杂
移动端适配困难
功能定制成本高

为此，p-camera-h5 —— 一款开箱即用的H5相机插件，支持拍照、录像、动态水印与样式高度定制化。

二、核心功能全景

即时捕获：拍照（PNG）、录像（WEBM/自动转MP4）
动态水印：支持定位+样式自定义
开放样式：支持样式自定义

三、快速集成指南

1. 基础配置

<!-- 容器需设置明确尺寸 -->
<div id="camera-wrap" style="width: 300px; height: 500px"></div>

2. 进阶配置

const camera = new pCameraH5({
  el: document.getElementById("camera-wrap"),
  style: `
    .p-camera-btn { 
      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
    }
  `,
  watermark: {
    text: `${new Date().toLocaleString()}`, // 动态水印
    position: "bottom-left",
    color: "rgba(255,50,50,0.7)",
    fontSize: "14px"
  }
});

2. 样式定制化

dom结构参考

  <div id="p-camera-h5">
    <div id="p-loading">加载中...</div>
    <div id="p-error"></div>
    <div id="p-container">
      <video id="p-video" autoplay playsinline></video>
      <canvas id="p-canvas" style="display:none;"></canvas>
    </div>
    <div id="p-watermark-btn">关闭水印</div>
    <div id="p-capture-btn">拍照</div>
    <div id="p-record-btn">录制</div>
    <div id="p-record-time">00:00</div>
  </div>

四、核心实现解析

1. 视频流处理架构

2. 关键技术点

双流分离：原始流与处理流独立，避免权限冲突
Canvas优化：使用requestAnimationFrame实现60FPS绘制

五、避坑指南

1. 常见问题排查

现象	解决方案
黑屏无画面	检查https协议/摄像头权限
水印位置偏移	确认容器是否为静态布局
移动端画面拉伸	添加`width=device-width` meta