更新记录

1.0.0（2026-06-01）

• 基于 Android Presentation 实现双屏显示。
• 提供副屏检测、打开、更新、关闭能力。
• 增加 uni-app x 首页演示页面。
• 因为副屏是 Android Presentation 原生窗口 所以必须源码授权版才可以修改副屏页

平台兼容性

uni-app x(4.08)

其他

tx-dual-screen

uni-app x / UTS Android 双屏显示插件。

功能说明

• 使用 Android Presentation 将内容显示到第二块屏幕。
• 主屏页面负责业务操作，副屏只负责展示文本内容。
• 适合食堂消费机、收银机、取号机、访客机等 Android 双屏设备。
• 普通手机通常只有一块屏幕，调用 isDualScreenAvailable() 会返回 false。

引入

import { isDualScreenAvailable, showDualScreen, updateDualScreen, dismissDualScreen } from '@/uni_modules/tx-dual-screen'
import type { TxDualScreenOptions } from '@/uni_modules/tx-dual-screen'

示例

const options = {
    title: '智慧食堂消费机',
    subtitle: 'tx-dual-screen 插件演示',
    mainText: '欢迎光临',
    message: '请在主屏操作，副屏内容会同步变化',
    badgeText: 'READY',
    footer: '主屏操作 · 副屏展示'
} as TxDualScreenOptions

showDualScreen(options)

API

isDualScreenAvailable() : boolean

检测当前 Android 设备是否存在第二块屏幕。

showDualScreen(options : TxDualScreenOptions) : boolean

打开副屏并显示内容。如果副屏已经打开，会直接更新内容。

updateDualScreen(options : TxDualScreenOptions) : void

更新副屏显示内容。副屏未打开时不会自动创建窗口。

dismissDualScreen() : void

关闭副屏窗口。

closeDualScreen() : void

dismissDualScreen() 的别名。

注意事项

• 不需要导入 Android Studio 示例工程中的 gradle-wrapper.jar，它不是运行库。
• utssdk/interface.uts 只保留纯 UTS 类型，不放 Android 原生类型。
• Android 上下文使用 UTSAndroid.getAppContext()。
• UTS 是强类型环境，插件内部已避免使用 !xxx、===、val 等不适合 uni-app x UTS 的写法。