# wwd-cocos-video

**Repository Path**: PodWareHouse/wwd-cocos-video

## Basic Information

- **Project Name**: wwd-cocos-video
- **Description**: Cocos Creator 项目的 WawaduoVideo Native Plugin TypeScript 封装，支持 RTMP / WebRTC 双协议播放。
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wwd-cocos-video

Cocos Creator 项目的 WawaduoVideo Native Plugin TypeScript 封装，支持 RTMP / WebRTC 双协议播放。

**仓库地址：** https://gitee.com/PodWareHouse/wwd-cocos-video

> 需配合 [WebRTCNavitePlugin](https://gitee.com/PodWareHouse/WebRTCNavitePlugin) 原生插件使用（Git Submodule 接入 `native/plugins/wawaduo-video`）。

## 安装

### 本地路径引用（推荐开发阶段）

在 Cocos 游戏项目的 `package.json` 中添加：

```json
{
  "dependencies": {
    "wwd-cocos-video": "file:../wwd-cocos-video"
  }
}
```

```bash
cd /path/to/YourCocosGame
npm install
```

每次修改本库源码后，在本库目录执行：

```bash
npm run build
```

### Git 依赖

```json
{
  "dependencies": {
    "wwd-cocos-video": "git+https://gitee.com/PodWareHouse/wwd-cocos-video.git#v1.0.0"
  }
}
```

### npm 安装（发布后）

```bash
npm install wwd-cocos-video
```

## 快速开始

```typescript
import { createWawaduoVideo } from 'wwd-cocos-video';

// WebRTC（原生视图自动全屏）
const player = createWawaduoVideo({
    type: 1,
    rtc: 1,
    url: 'webrtc://your-server/live/stream',
    link: 'https://your-server/rtc/v1/play/',
    onFirstFrame: () => console.log('首帧渲染'),
    onError: () => console.log('播放错误'),
});

// RTMP
const rtmpPlayer = createWawaduoVideo({
    type: 1,
    rtc: 0,
    url: 'rtmp://your-server/live/stream',
    link: '',
});

player.stop();
```

## 开发与发布

```bash
npm install
npm run build
npm publish   # 需 npm login
```

发版时更新 `package.json` 的 `version` 并打 tag：

```bash
git tag -a v1.0.0 -m "首个稳定版本"
git push origin v1.0.0
```

## 依赖

- Cocos Creator >= 3.6.3
- iOS Native Plugin：[WebRTCNavitePlugin](https://gitee.com/PodWareHouse/WebRTCNavitePlugin)（Submodule）
- 仅 iOS 真机运行时 `WawaduoVideoNative` 原生类可用

## 相关仓库

| 仓库 | 用途 |
|------|------|
| [WebRTCNavitePlugin](https://gitee.com/PodWareHouse/WebRTCNavitePlugin) | iOS Native Plugin（C++/Swift） |
| [wwd-cocos-video](https://gitee.com/PodWareHouse/wwd-cocos-video) | TypeScript 封装（本仓库） |
| [WawaduoVideo](https://gitee.com/librarybyself/wawaduo-video) | iOS 播放 SDK（CocoaPods） |