openharmony投屏方案

一、核心投屏方案对比

二、关键技术原理详解

分布式屏幕API方案
架构组成：

设备发现 → 软总线连接 → 分布式数据管理 → 屏幕帧编码 → 跨设备渲染

核心接口：

// 获取设备列表
const screens = await screen.getAllScreens();

// 启动镜像模式
screen.makeMirror(screenId, (err, data) => {
  if (err) console.error("镜像失败:", err);
  else console.log("镜像成功，目标设备ID:", data.deviceId);
});

// 停止镜像
screen.stopMirror(screenId);

WiFi直连投屏方案
协议栈结构：

RTSP（会话控制） → RTP（视频传输） → UDP（低延迟传输） → 硬件编解码加速

CastEngine组件使用：

import castEngine from '@kit.MediaCastKit';

// 创建投屏源
const source = castEngine.createSource({
  protocolType: castEngine.ProtocolType.MIRACAST
});

// 启动投屏会话
source.startCasting({ targetDevice: "TV_DEVICE_ID" });

第三方工具方案
实现流程：

HDC连接设备 → UiDriver截屏 → JPEG帧编码 → WebSocket传输 → 浏览器Canvas渲染

帧捕获核心逻辑：

// 通过HDC获取屏幕帧
device := hdckit.ConnectDevice("192.168.1.100")
frameChan := device.UiDriver().StartScreenCapture(30) // 30fps

// WebSocket推送
for frame := range frameChan {
  ws.BroadcastBinary(frame.EncodeJPEG(80)) // 80%质量压缩
}

三、方案选型建议

低延迟协同场景
优先使用分布式API方案，示例调用链：

// 设备发现
import deviceManager from '@kit.DistributedDeviceManagerKit';
deviceManager.getTrustedDeviceList((err, devices) => {
  const tvDevice = devices.find(d => d.type === 'smartTV');
});

// 启动镜像投屏
import screen from '@kit.DistributedScreenKit';
screen.makeMirror(localScreen.id, tvDevice.id);

跨生态设备投屏
采用CastEngine的WiFi方案，需注意权限声明：

// config.json
"reqPermissions": [
  { "name": "ohos.permission.DISTRIBUTED_DATASYNC" },
  { "name": "ohos.permission.MEDIA_CAPTURE" }
]

开发调试场景
OHScrcpy类工具推荐配置：

# 启动HDC端口映射
hdc -t device_id forward tcp:8080 tcp:8080
# 接收端访问 ws://localhost:8080/screen

四、OpenHarmony 6 增强特性

动态分辨率适配
新增
onResolutionChange回调：

screen.on('resolutionChange', (newSize) => {
  canvas.width = newSize.width;
  canvas.height = newSize.height;
});

多窗口投屏控制

// 指定窗口投屏
window.getTopWindow().setMirrorTarget(deviceId);

// 动态切换投屏源
window.getTopWindow().switchMirrorSource(newWindowId);

能效优化策略

// 根据网络质量动态调整帧率
screen.setAdaptiveFramerate({
  min: 15,
  max: 60,
  policy: 'bandwidth' // 或 'latency'
});

五、典型问题排查

黑屏问题

检查
ohos.permission.DISTRIBUTED_SCREEN权限验证目标设备是否支持
screen.makeMirror接口

高延迟现象

// 开启性能监控
screen.enableQoSMonitor({
  reportInterval: 1000,
  callback: (stats) => {
    console.log(`当前延迟:${stats.latency}ms 帧率:${stats.fps}`);
  }
});

设备发现失败

确认设备在同一局域网检查分布式组网状态：

hdc shell dumpsys distributed_hardware