Vidgear WebGear API 高级使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00456/article/details/148575935

Vidgear WebGear API 高级使用指南

vidgear A High-performance cross-platform Video Processing Python framework powerpacked with unique trailblazing features :fire: 项目地址: https://gitcode.com/gh_mirrors/vi/vidgear

前言

Vidgear是一个强大的Python视频处理库，其中的WebGear组件能够将视频流高效地传输到网页浏览器。本文将深入探讨WebGear API的高级用法，帮助开发者更好地利用这一工具构建视频流应用。

WebGear与不同色彩空间的配合使用

WebGear默认仅支持BGR色彩空间的帧作为输入，但通过jpeg_compression_colorspace参数，我们可以指定输入帧的色彩空间。

灰度视频流示例

以下示例展示了如何将灰度视频流传输到浏览器：

import uvicorn
from vidgear.gears.asyncio import WebGear

# 配置参数
options = {
    "frame_size_reduction": 25,
    "jpeg_compression_colorspace": "GRAY",  # 设置为灰度
    "jpeg_compression_quality": 90,
    "jpeg_compression_fastdct": True,
    "jpeg_compression_fastupsample": True,
}

# 初始化WebGear并指定色彩空间转换
web = WebGear(
    source="foo.mp4", 
    colorspace="COLOR_BGR2GRAY", 
    logging=True, 
    **options
)

# 启动Uvicorn服务器
uvicorn.run(web(), host="0.0.0.0", port=8000)

# 安全关闭应用
web.shutdown()

技术要点：

jpeg_compression_colorspace支持多种色彩空间格式
通过OpenCV的色彩空间转换函数可实现输入帧的预处理
性能参数可优化传输效率

使用自定义视频源

WebGear允许开发者定义自己的视频源处理逻辑，为特殊场景提供灵活性。

OpenCV自定义源示例

import uvicorn, asyncio, cv2
from vidgear.gears.asyncio import WebGear
from vidgear.gears.asyncio.helper import reducer

web = WebGear(logging=True)

async def my_frame_producer():
    stream = cv2.VideoCapture(0)
    while True:
        grabbed, frame = stream.read()
        if not grabbed:
            break
            
        # 在此处添加自定义帧处理逻辑
        frame = await reducer(frame, percentage=30, interpolation=cv2.INTER_AREA)
        encodedImage = cv2.imencode(".jpg", frame)[1].tobytes()
        yield (b"--frame\r\nContent-Type:image/jpeg\r\n\r\n" + encodedImage + b"\r\n")
        await asyncio.sleep(0)
    stream.release()

web.config["generator"] = my_frame_producer
uvicorn.run(web(), host="localhost", port=8000)
web.shutdown()

注意事项：

使用自定义源时JPEG帧压缩功能将被禁用
需要自行处理帧编码和传输格式
异步编程模型确保高性能

自定义挂载点

WebGear支持添加自定义静态文件挂载点，便于扩展功能。

from starlette.routing import Mount
from starlette.staticfiles import StaticFiles

# 初始化WebGear后添加挂载点
web.routes.append(
    Mount("/test", app=StaticFiles(directory="/path/to/folder"), name="test")
)

应用场景：

托管前端资源文件
提供下载内容
扩展静态页面

自定义网页路由

通过集成Starlette的路由系统，可以轻松添加自定义网页。

from starlette.templating import Jinja2Templates
from starlette.routing import Route

template = Jinja2Templates(directory="/path/to/templates")

async def hello_world(request):
    return template.TemplateResponse("hello.html", {"request": request})

web.routes.append(Route("/hello", endpoint=hello_world))

开发建议：

使用Jinja2模板引擎实现动态页面
保持路由逻辑简洁
合理组织模板文件结构

中间件集成

WebGear原生支持ASGI中间件，可扩展应用行为。

from starlette.middleware import Middleware
from starlette.middleware.cors import CORSMiddleware

web.middleware = [
    Middleware(
        CORSMiddleware,
        allow_origins=["*"],
        allow_methods=["*"],
        allow_headers=["*"],
    )
]

常用中间件：