> For the complete documentation index, see [llms.txt](https://ujhhgtgteams.gitbook.io/wekit-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ujhhgtgteams.gitbook.io/wekit-docs/liao-tian/virtual-voip-video.md).

# 虚拟视频通话

> 在微信视频通话相机预览中播放本地视频或网络直播流

## 类别

聊天, 音视频通话

## 类型

可开关 & 可点击

## 描述

在微信视频通话的相机预览中播放视频内容, 替代真实的摄像头画面。支持本地视频文件和网络直播流 (HTTP/HLS/RTSP) 两种来源, 可选择竖屏/横屏或由系统自动检测视频方向。适用于需要预录内容、直播推流或保护真实画面的场景。

## 使用方法

启用后点击以打开配置弹窗:

1. **选择来源类型**: 在"本地文件"与"网络流地址"之间切换
   * 本地文件: 从系统相册选择一个视频文件, 固定在 `virtual_voip_video.mp4`
   * 网络流: 输入流媒体 URL (支持 HTTP/HLS/RTSP 协议)
2. **方向设置**: 选择视频显示方向
   * 自动: 根据视频元数据自动检测 (仅本地文件支持)
   * 竖屏 / 横屏: 强制指定方向
3. 确认后即应用, 下一次视频通话时生效

> 提示: 网络流模式下只播放一次 (不循环), 适合直播流; 本地文件将循环播放。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ujhhgtgteams.gitbook.io/wekit-docs/liao-tian/virtual-voip-video.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.