# VideoGLSample

**Repository Path**: creator-master/VideoGLSample

## Basic Information

- **Project Name**: VideoGLSample
- **Description**: sample project for videogl
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-03-28
- **Last Updated**: 2025-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VideoGL Sample

## 简介

这个工程是用来演示 VideoGL 的样例工程.

## 支持平台

* Web
* Android
* iOS

_注意_: 不支持 Cocos/iOS 模拟器.

## Creator 版本

* Cocos Creator 3.6.1+

## NDK 版本

* 20.0.5594570

## Android-ABI

* armv8-a

## 使用步骤

1. 你需要已拥有 VideoGL 这个插件.
2. 将 VideoGL 插件安装到本工程中.
3. 在 Creator 的菜单, 点击 Extension(扩展) -> VideoGL -> Install
4. 这时应该能在 VideoGLSample 工程的 Assets 中看到 VideoGL 的脚本
5. 对于网页, 可以直接运行, 查看效果.
6. 对于 Android 工程还需要添加 `READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE` 两个权限
7. 对于 Android/iOS , 直接正常导出, 编译运行就可以. VideoGL 插件会自动修改工程的编译文件.

__注意__: Android 目前只支持 armv8-a . 同时 NDK 最好使用 20.0.5594570

## 已知问题

1. 在 Creator 中导出 iOS 工程, 再导出 Android 工程, 这时 Android 工程可能不会导出成功, `native/engine/android` 目录没有导出 `build.gradle` .

2. `DOMException: The operation is insecure.`, 当在 Web 平台使用与当前不同 Server 的远程视频 URL 时, 可能会遇到这个提示. 这时视频需要与当前的 Web Server 相同.(简而言之就是不能跨域)

## 测试用法

* 将视频直接在3D场景中作为一个展示屏输出.

![3DVideo](res/3dvideo.gif)

* 将视频的输出做为背景, 在3D场景中放置合适的模型.

![Panorama](res/Panorama.gif)