# dlmirror

**Repository Path**: DragonCodingPlus/dlmirror

## Basic Information

- **Project Name**: dlmirror
- **Description**: Android异地投屏工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DL投屏 — 异地无线投屏工具

> 手机屏幕内容通过 UDP + MPEG 无线传输至电脑端，OBS Studio 接收后可整合直播推流。

---

## 目录

- [项目简介](#项目简介)
- [解决的核心痛点](#解决的核心痛点)
- [核心功能](#核心功能)
- [使用流程](#使用流程)
- [数据流向](#数据流向)
- [技术架构](#技术架构)
- [应用截图](#应用截图)
- [独特优势](#独特优势)
- [使用场景](#使用场景)
- [常见问题](#常见问题)
- [配套工具](#配套工具)

---

## 项目简介

**DL投屏** 是一款 Android 无线投屏应用，基于 **MediaProjection** 原生 API 截取手机屏幕实时画面，经由 **H.264 硬件编码** → **MPEG-TS 封包** → **UDP 协议** 无线传输至指定设备。接收端使用开源的 **OBS Studio** 通过 UDP 端口监听接收并解码播放，支持整合多路素材后推流至各大直播平台。

与市面上大多数投屏工具不同，DL投屏利用 **IPv6 全局地址** 实现真正的异地投屏——手机在任何有网络的地方，都能将屏幕内容发送至远处拥有公网 IPv6 地址的电脑。

### 基本信息

| 属性 | 说明 |
|------|------|
| 应用名称 | DL投屏 |
| 平台 | Android |
| 投屏方式 | 无线（WiFi / 移动网络） |
| 适用场景 | 手游直播、App 演示、远程教学、远程协助 |
| 关键技术 | MediaProjection、H.264、MPEG-TS、UDP、IPv6 |
| 接收端 | OBS Studio（支持 Windows / macOS / Linux） |

---

## 解决的核心痛点

### 痛点一：有线连接的束缚

传统投屏方案依赖数据线或专用硬件（采集卡/投屏器），连接繁琐、线缆易损、移动受限。

**DL投屏的解法**：基于 UDP 协议实现完全无线传输。手机与电脑在同一网络下即可投屏，无需任何数据线或额外硬件，自由移动不受限制。

### 痛点二：局域网限制，无法远程投屏

大多数投屏工具（如 Miracast、AirPlay）仅支持同一 WiFi 下的局域网投屏，离开局域网后功能失效，无法满足远程协作和异地直播需求。

**DL投屏的解法**：利用公网 IPv6 全局地址，电脑端获取 IPv6 地址后，手机在外网任何地点都可通过移动网络向其发送 UDP 视频流，实现真正的异地投屏。无需端口映射、无需内网穿透。

### 痛点三：投屏后无法直播分发

普通投屏只能本地观看，无法将投屏内容进一步整合到直播流程中。内容创作者需要同时操作多套工具，流程繁琐。

**DL投屏的解法**：OBS Studio 通过 UDP 端口监听直接接收投屏画面作为视频源，可与摄像头、图片、文字等素材自由编排。一键推流至抖音、B站、斗鱼等直播平台。

---

## 核心功能

### 1. MediaProjection 截屏

基于 Android 原生 MediaProjection API（Android 5.0+）实时截取手机屏幕内容。无需 Root 权限，用户授权后即可采集全屏或应用界面的画面，帧率流畅。

### 2. 设备列表管理

主界面展示已添加的接收设备列表，每台设备显示 IP 地址和端口号。支持添加新设备、删除已有设备，可快速在不同投屏目标之间切换。

### 3. QR Code 扫码添加

添加设备界面支持扫描二维码自动填入 IP 地址。电脑端使用 IP 地址工具生成二维码，手机扫码即可，免去手动输入 IP 的繁琐操作。

### 4. UDP 无线传输

屏幕画面经 H.264 编码后，以 MPEG-TS 格式封包，通过 UDP 协议发送至目标 IP 地址和端口。UDP 无连接特性带来极低延迟，适合实时流媒体传输。

### 5. IPv6 异地投屏

电脑端拥有公网 IPv6 地址时，手机可通过移动网络（4G/5G）从任何地点向该地址发送投屏数据流。突破局域网限制，支持真正的远程异地投屏。

### 6. OBS 直播整合

OBS Studio 是免费开源的直播软件，通过「媒体源」监听 UDP 端口接收 MPEG 流，内置硬件解码器还原投屏画面。支持多场景编排和多平台同步推流。

---

## 使用流程

### 第一步：电脑端准备

1. 使用 [IP 地址工具](https://mjlong123.top/products/iptool) 查看本机 IPv4/IPv6 地址
2. 点击生成二维码，手机后续扫码使用
3. 打开 OBS Studio，添加「媒体源」，输入格式选择 `mpegts`，监听地址填入 `udp://@:端口号`

### 第二步：扫码添加设备

1. 手机打开 DL投屏应用
2. 进入添加设备界面
3. 点击扫码功能，扫描电脑屏幕上的 IP 二维码
4. IP 地址自动填入，保存设备

### 第三步：授权截屏

1. 在设备列表中选择目标设备
2. 点击开始投屏
3. 系统弹出 MediaProjection 授权对话框
4. 用户确认后，应用开始截取屏幕画面

### 第四步：编码与打包

1. 屏幕画面通过 Android 硬件编码器进行 H.264 编码
2. 编码后的视频帧以 MPEG-TS 格式封包
3. 数据包通过 UDP 协议发送至目标 IP 地址和端口

### 第五步：无线/异地传输

- **局域网模式**：手机和电脑在同一 WiFi 下，直接通过内网 IP 发送
- **异地模式**：电脑拥有公网 IPv6，手机通过移动网络直接发送至 IPv6 地址

### 第六步：OBS 接收与直播

1. OBS 媒体源自动接收 UDP 流并解码显示
2. 将投屏画面与其他素材（摄像头、文字、图片）整合编排
3. 一键推流至抖音、B站、斗鱼等直播平台

---

## 数据流向

```
手机屏幕 → MediaProjection 截取 → H.264 硬件编码 → MPEG-TS 封包 → UDP 发送 → OBS 监听端口接收 → 解码显示 → 推流直播
```

### 各环节说明

| 环节 | 说明 |
|------|------|
| 屏幕采集 | Android MediaProjection API 实时截取屏幕帧 |
| 视频编码 | H.264 硬件编码器，高效利用 GPU，低 CPU 占用 |
| 格式封装 | MPEG-TS 流媒体传输标准格式，OBS 原生支持 |
| 网络传输 | UDP 协议，无连接低延迟，直接向目标地址发包 |
| 接收解码 | OBS 媒体源内置解码器，支持硬件加速解码 |
| 直播推流 | OBS 整合多路素材后，RTMP 推流至各大平台 |

---

## 技术架构

### MediaProjection（屏幕采集层）

- Android 5.0 (API 21) 以上原生支持
- 通过 `MediaProjectionManager` 获取授权，创建 `VirtualDisplay`
- 支持全屏采集，可指定分辨率、帧率、码率参数
- 无需 Root 权限，用户授权后即可工作

### H.264 编码（视频编码层）

- 使用 Android MediaCodec 硬件编码器
- 格式：`video/avc`（H.264/AVC）
- 硬件加速编码，高效利用 GPU，降低 CPU 占用
- 可配置编码参数：分辨率、帧率、码率、关键帧间隔

### MPEG-TS 封装（格式封装层）

- MPEG-2 Transport Stream (TS) 是专为流媒体传输设计的标准格式
- OBS Studio 的「媒体源」原生支持 `mpegts` 输入格式
- 支持音视频同步封装，容错性好

### UDP 协议（网络传输层）

- 无连接协议，无需握手即可向目标地址发送数据
- 极低延迟，适合实时流媒体传输
- 支持 IPv4 和 IPv6 寻址
- 通过 DatagramSocket 进行数据包的发送

### IPv6（网络寻址层）

- 海量地址空间，每个设备可获得公网 IPv6 地址
- 无需 NAT 转换，端到端直接可达
- 无需端口映射或内网穿透工具
- 目前国内外主流宽带运营商已支持 IPv6

### OBS Studio（接收与直播层）

- 免费开源的直播/录屏软件
- 通过「媒体源」监听指定 UDP 端口接收 MPEG 流
- 内置 FFmpeg 解码器，支持硬件加速解码
- 支持多场景编排，RTMP 推流至主流直播平台

---

## 应用截图

### 手机端

| 主界面 | 添加设备 | 投屏操作 |
|:---:|:---:|:---:|
| 设备列表管理，显示 IP 和端口 | 扫码或手动输入添加设备 | 选择设备开始无线投屏 |

### 电脑端

| IP 地址工具 | OBS 添加媒体源 | OBS 接收画面 |
|:---:|:---:|:---:|
| 显示 IP 并生成二维码 | 配置 UDP 监听和 MPEG 格式 | 实时显示投屏画面 |

---

## 独特优势

### 真·异地投屏

互联网上绝大多数投屏工具只能局域网使用，DL投屏利用 IPv6 全局寻址能力，手机在任何有网络的地方都能将屏幕投送到远处电脑，这是普通投屏工具无法做到的。

### 零硬件成本

无需购买投屏器、采集卡等硬件设备。手机安装应用 + 电脑运行 OBS（免费开源）即可。纯软件方案，大幅降低使用门槛。

### 直播生态整合

投屏画面可直接作为 OBS 的一个视频源，与摄像头、图片、文字、浏览器等素材自由混合编排。支持同时向多个直播平台推流，内容创作效率倍增。

### 低延迟实时传输

UDP 协议天然低延迟，无需 TCP 握手和重传等待。配合硬件编解码加速，从手机截屏到 OBS 显示画面的延迟可控制在亚秒级。

---

## 使用场景

- **手游直播**：手机游戏画面直接投屏到 OBS，融合摄像头和弹幕后推流直播
- **App 演示**：远程向客户演示 App 操作流程，无需到场
- **教学培训**：讲师手机操作实时投屏到大屏幕或直播平台
- **远程协助**：将手机屏幕共享给远程技术支持人员查看
- **内容创作**：将手机端创作的内容投屏至电脑进行后期整合

---

## 常见问题

### DL投屏和DL推流有什么区别？

DL投屏是基于 MediaProjection 截取手机屏幕内容进行投屏，适合展示手机操作、App 演示、手游直播等场景。DL推流是基于 Camera 采集摄像头画面进行推流，适合现场拍摄、实物展示等场景。两者都采用 UDP + MPEG 传输，OBS Studio 均可直接接收。

### 如何实现异地投屏？需要什么条件？

异地投屏的核心条件是电脑端拥有公网可访问的 IPv6 地址。目前大多数宽带运营商已支持 IPv6，只需在路由器中开启 IPv6 功能即可。电脑获取 IPv6 全局地址后，手机在外网通过移动网络也能直接向该地址发送 UDP 流数据，OBS 监听对应端口即可接收。

### 电脑端如何获取 IP 地址并生成二维码？

推荐使用 [IP 地址工具](https://mjlong123.top/products/iptool)（支持 Windows 和 Mac），可一键显示本机 IPv4 和 IPv6 地址并自动生成二维码。手机打开 DL投屏添加设备界面，扫描电脑屏幕上的二维码即可自动填入 IP 地址。

### OBS Studio 如何配置接收投屏画面？

1. 在 OBS Studio 中，点击「来源」区域的 **+** 按钮
2. 选择「媒体源」
3. 取消勾选「本地文件」
4. 在「输入」中填写 `udp://@:端口号`（如 `udp://@:8080`）
5. 「输入格式」选择 `mpegts`
6. 建议勾选「使用硬件解码」
7. 点击确定完成配置

### 投屏画面延迟大吗？对网络有什么要求？

DL投屏采用 UDP 协议，延迟极低。局域网内投屏延迟通常在几百毫秒以内。异地投屏的延迟取决于手机端上行带宽和电脑端的下行带宽。建议手机端上行带宽不低于 5Mbps，电脑端下行带宽充裕即可获得流畅体验。编码码率可在应用中调节以适配不同网络环境。

### 支持哪些 Android 版本？

需要 Android 5.0 (API 21) 及以上版本，MediaProjection API 从 Android 5.0 开始提供。

---

## 配套工具

### IP 地址工具

电脑端 IP 地址查看与二维码生成工具，支持 Windows 和 macOS 双平台。

- 实时显示本机 IPv4 和 IPv6 地址
- 一键生成 IP 二维码，手机扫码即获取
- 点击 IP 文本即可拷贝到剪贴板
- 下载地址：[https://mjlong123.top/products/iptool](https://mjlong123.top/products/iptool)

### OBS Studio

免费开源的直播/录屏软件，作为 DL投屏的接收端使用。

- 官网下载：[https://obsproject.com/](https://obsproject.com/)
- 支持 Windows / macOS / Linux
- 通过媒体源监听 UDP 端口接收投屏画面

---

## 技术关键词

`Android` `MediaProjection` `H.264` `MPEG-TS` `UDP` `IPv6` `OBS Studio` `无线投屏` `异地投屏` `屏幕镜像` `直播推流`

---

## 许可

DL投屏为 DragonCoding 个人作品。保留所有权利。

---

## 作者

- **DragonCoding**
- 网站：[mjlong123.top](http://mjlong123.top)
- Gitee：[DragonCodingPlus](https://gitee.com/DragonCodingPlus)
- CSDN：[mjlong123123](https://blog.csdn.net/mjlong123123)

---

*文档最后更新：2025年6月*