---
id: v4-2392-tx-ip-platform-integration
title: Tx-IP Platform Integration — Config-T UI adjustment
doc_type: design-record
status: requirement
target_release: "8.4"
last_updated: 2026-08-18
sources:
  - { type: jira, ref: "V4-2392", url: "https://tvunetworks.atlassian.net/browse/V4-2392" }
  - { type: jira, ref: "V4-1676", url: "https://tvunetworks.atlassian.net/browse/V4-1676" }
  - { type: slack, ref: "TM1000V4 IP Product Requirement Confirmation（需求确认线 · Matt McEwen 答复）", url: "https://tvunetworks.slack.com/archives/C021E1BNTPF/p1786947224776899" }
  - { type: slack, ref: "TM1000v4 IP 界面调整讨论（开发内部适配线 · Dave 清单 + platform 10086）", url: "https://tvunetworks.slack.com/archives/C021E1BNTPF/p1786947752014739" }
figma:
  file: jnlIId30lS3xjRmZnZTWQy
  nodes:
    - { id: "2:8", label: "Section — Changes on Config-T 20260818（现状截图 + 红框移除标注 + PRD 卡）", url: "https://www.figma.com/design/jnlIId30lS3xjRmZnZTWQy/TX-IP-v8.4--20260818?node-id=2-8" }
    - { id: "6:2", label: "PRD 卡 — Tx-IP Platform Integration (Config-T)", url: "https://www.figma.com/design/jnlIId30lS3xjRmZnZTWQy/TX-IP-v8.4--20260818?node-id=6-2" }
---

# Feature Design Record — Tx-IP Platform Integration（V4-2392）

- **JIRA**：[V4-2392](https://tvunetworks.atlassian.net/browse/V4-2392)（parent [V4-1676](https://tvunetworks.atlassian.net/browse/V4-1676) RPS One Software 8.4 bugs & tasks controller）　**Scope**：Config-T (Local UI) 单端
- **Owner(dev)**：Bonnie Zhou（Config-T）／Jack Wu · renhu（平台号）　**PM**：Trevor Yao　**需求方**：Matt McEwen　**Designer**：Nancy Zeng
- **Status**：需求已定稿，PRD 已交付；mockup 未做（本轮只交 PRD）　**日期**：2026-08-18

---

## 1. 问题与根因

TX-IP 是基于 TM1000V4 的**新硬件形态**，不是 bug 也不是回归：仅 3 个 modem、无物理 SDI / HDMI 输入、无 return video HDMI 输出，产品定位 **IP input only**（Matt McEwen 2026-08-18 原话 "Yes, for TX-IP, it is IP input only. Nothing else."）。

Config-T 目前用**同一套界面服务全部 V4 形态**，因此在 TX-IP 上会暴露该硬件不具备的功能入口（多路通道切换、SDI/HDMI 采集设置、录制、RVF HDMI 回传、4:2:2/10-bit、4K/FHD 等）。根因是界面未按平台能力分支，需要按 **平台号 + 卡类型** 做条件隐藏。

平台侧已就位（Jack Wu / renhu，2026-08-18 当天完成）：

| 字段 | 值 |
|---|---|
| `platform_id` | `10086` |
| `platform` | `TX-IP` |
| `platform_display_name` | `"TX-IP"` |
| `cap_card` | `NoCard`（`cap_card_id=0`） |
| `platform_in` | `OneV4` |
| baseboard / CPU | `CM11EBI58W` / `i5-1135G7` |

## 2. Scope & Non-goals

**做**：Config-T (Local UI) 在 TX-IP 平台上的界面隐藏 / 取值限制，共 12 条功能需求（见 PRD `6:2` §4）。

**不做（明确排除）**：

- **LCD / Touch Screen 端** — Dave 定的顺序是「先列 Config-T 再列 LCD」，LCD 按项目惯例另行拆单（V4 LCD → Edward Wu）。
- **Receiver 端兼容** — 新 platform `10086` 老版本 R 不识别；Ari Zheng 确认 LR 8.3 起支持，Trevor 认为「8.3 and above should work fine」，Dave 2026-08-18 14:57 另提「LR 8.3 之前上报为 TM1000v4」的方案**尚无回复**。属 Receiver 侧 + 仍是 open item ⇒ 不进 PRD（PRD 禁 open questions），也不在 TVU Pack scope。
- **本轮不产出 mockup / UX 交付卡 / User Journey Map** — owner 只要 PRD；这三件在真正画 AFTER 效果图那一轮补（届时按 §6-JIRA ⑤ 走）。

## 3. Baseline 参考

现状基线 = owner 自建的 Config-T 实机截图 10 张，全部收在 Section `2:8`，红框即移除标注。逐图归属：

| node | 页面 | 红框内容 | 对应 PRD req |
|---|---|---|---|
| `1:3` | Dashboard（System / Network / Config / Video / Power） | PID 区 + 手写「只有单路」· Network 段 1/2/3/4（带划线）· Config 段 Auto-Recording + Recording Bitrate · Video 段 1/2/3/4（带划线）+ Max Format for HDMI + Input Port | 1, 2, 5, 8 |
| `1:6` | Live → Return Video | `Source Switcher` tab（框+划线）·`Return Video` tab（仅框）· **Inner HDMI** + **V-box (HDMI2)** 两组 | 9, 10 |
| `1:9` | Live → Encoder | 1/2/3/4 · HDR/HLG + Chroma Subsampling（配红字「Restrict support to 8-bit and 4:2:0 only…」）· Audio channel `16-ch`（带划线） | 2, 3, 4 |
| `1:12` | Live → Receiver | 仅 1/2/3/4 | 2 |
| `2:3` | File → Recorder | 红字 **"Remove this page"** + `Recorder` tab + 整页（Download 段 / Recording File 列表） | 5 |
| `2:6` | Advanced 下拉菜单 | `Progressive Download`（红字 Remove）·`4K/FHD`（红字 Remove） | 6, 7 |
| `2:10` | Advanced → MediaMind Setting | 仅 1/2/3/4 | 2 |
| `2:13` | Advanced → Token | 仅 1/2/3/4 | 2 |
| `1:21` | General → Software Upgrade | `Software Upgrade` tab + 整个「Select an Appropriate Software Version」套餐对比区 | 12 |
| `3:16` | Live → IP Source | `Input Type of source 1` 的 **`HDMI/SDI/USB`** 选项 | 11 |

### 红框标注语义（本文件实证，dev 读图必看）

| 标注 | 含义 | 实例 |
|---|---|---|
| 红框 **+ 斜划线** | 整体移除 | Dashboard 1/2/3/4 · Audio `16-ch` · `Source Switcher` tab |
| **仅红框**（无划线） | 该处有改动但**非全删** | `Return Video` tab（只删页内两组）· Encoder HDR/HLG 行（限制取值，配红字说明） |
| 红框 + **红字说明** | 按红字执行 | `"Remove this page"`（File→Recorder）·`"Restrict support to 8-bit and 4:2:0 only…"` |

## 4. 设计 — 状态与指示模型

本轮**无新界面状态**：需求形态是「按平台条件隐藏既有元素 / 收窄既有取值域」，不新增控件、不新增状态机。判定入口单一：

```
platform_id == 10086 && platform == "TX-IP"（cap_card == NoCard）
  → 隐藏 req 2–12 所列入口
其他平台（TM1000V4 10085 / TM1100 …）
  → 界面完全不变
```

唯一需要注意的非纯隐藏项是 **req 3**：HDR/HLG 与 Chroma Subsampling **保留两行**、把取值锁到 `8-bit` + `4:2:0` 并设为默认、移除其余选项 —— 不是整行删除（红字明确要求）。

## 5. UX 交付

- **产品 UI 文案**：本轮零新增文案（纯隐藏 / 收窄取值），故无 M33 单语文案产出。
- **注释层**（双语，M23）：PRD 卡 `6:2` —— 6 段固定结构（Source / Background / Current State / Requirements / Acceptance / Priority & Timeline），12 条功能需求 + 6 条验收，43 个 TEXT 节点。
- **组件来源**：无库组件 instance（PRD 卡为注释层自建件，navy `#2B2D42` + cyan `#33A4FD` 按 M23 卡族规范）。Jira 引用走 **M23.8.1 文字 + `setRangeHyperlink`**，未用 `Jira requirement` 组件 —— 该组件是 file-local、本文件无现成 instance 可 clone，跨文件 `importComponentByKeyAsync` 必 fail（M23.8 已载明）。

## 6. 决策记录

| # | 决策 | 理由 |
|---|---|---|
| D1 | **UVC / webcam 列为移除项** | Dave 的提问原文即含 UVC，Matt 回 "IP input only. Nothing else."；owner 2026-08-18 17:01 已把 Slack 里那条「待 Matt/Trevor 二次确认」删掉，改按「只支持 IP Source」执行 |
| D2 | **UVC 的落点 = IP Source 页 `Input Type of source` 的 `HDMI/SDI/USB` 选项** | owner 指出该项已在 `3:16` 圈红；USB 与 HDMI/SDI 合并为同一 radio 选项，不是独立控件 |
| D3 | **NDI 保留** | Matt："NDI support should be possible … as part of the IP input function"；TX-IP 为 IP input only ⇒ NDI 属保留范围。req 11 显式写出保留项，防 dev 把三选一连 NDI 一起删 |
| D4 | **RVF 只移除依赖 HDMI 输出的两组**（Inner HDMI / V-box HDMI2），保留 Pack LCD / Phone-Tablet 两组与 `Return Video` tab 本身 | Matt 原话只否定 **HDMI output**；后两组回传不经 HDMI 输出口，物理上仍成立。owner 2026-08-18 拍板选此档，并指出红框「只圈了这两项」。⚠️ **推翻**了 Dave 清单第 2 条字面的「隐藏 RVF」（整页） |
| D5 | **Source Switcher tab 独立成 req 10** | 原与 RVF 合在一条，正是把「两个 tab 都删」读岔的地方；拆开后 req 重编号至 12 条 |
| D6 | **录制移除范围 = 两个入口** | Dashboard Config 段（`1:3`）+ File → Recorder 整页（`2:3` 红字 "Remove this page"），不是只有一个 tab |
| D7 | **Receiver 兼容不进 PRD** | 见 §2 Non-goals |
| D8 | **PRD 落位最终在 Section `2:8` 内左侧**（rel 181,220） | 我初版按 M23.12「BEFORE 在 feature Section 外」放在 Section 左侧**外部**（abs -1905, gap 120）；owner 随后手动把卡拖进 Section 并把 Section 改名 `Changes on Config-T 20260818` ⇒ 按 owner 布局为准，不移回 |

## 7. 依赖 / 待办

- **平台号**：已完成（Jack Wu 建号 + renhu 适配 peerid 计算，`TransporterT-8.1.2.120build120`）。Jack 已通知 msgpipe / configT on CC 等服务配合支持。
- **UVC 红框依据**：owner 确认 `3:16` 已圈，PRD req 11 与之对应 ✅
- **IP Source 页的 1/2/3/4**：`3:16` 上通道切换器**未**单独圈红，但 req 2 的口径是「wherever it appears」⇒ 该页同样要移除。dev 若按图逐项对照可能漏，已在 handoff 标注。
- **B-COVERAGE 61 条 — 非单一原因，见 handoff §4 第 1 条的两半拆解**（2026-08-18 owner 质疑后重核）。要点：注释层的 fill / stroke（44 条）**结构上无 DS token 可绑**（实测 DS 98 个变量零注释色，M23 navy/cyan 是规则自带值，M-COLOR §C4 禁与品牌色混用）⇒ 不是待办；spacing（17 条）订阅库后可绑（`Basic Size/#4 #8 #16 #32`）。**订阅状态须用 `teamLibrary.getAvailableLibraryVariableCollectionsAsync()` 判**，不能用 `getLocalVariableCollectionsAsync()`（产品文件是订阅方，local 恒空 —— Config-T 亦然）。
- **本文件未订阅 DS 库**（真判据实测 `[]`）⇒ 影响的是**下一轮画 AFTER 效果图**（M32 library-first 要 import DS 组件 instance），需 owner 在 Figma 启用订阅；纯 PRD 轮不依赖。
- **B-TYPO 存量类别**：注释卡字号 18/15/13/12/11 由 M23.14 (B) 规定，本就不在 M-FONT 的 textStyle grid `{12,14,16,18,20,22,24}` 上，DS 亦无对应注释层 textStyle ⇒ §M49.1 owner-deferred，与 V4-2333 轮三十二同类。

## 8. 交付链接

- **Figma Section**：[`2:8` Changes on Config-T 20260818](https://www.figma.com/design/jnlIId30lS3xjRmZnZTWQy/TX-IP-v8.4--20260818?node-id=2-8)（10 张现状截图 + 红框标注 + PRD 卡）
- **PRD 卡**：[`6:2`](https://www.figma.com/design/jnlIId30lS3xjRmZnZTWQy/TX-IP-v8.4--20260818?node-id=6-2)（680×2039）
- **handoff**：[`docs/handoffs/2026-08-18-v4-2392-tx-ip-config-t-handoff.md`](../handoffs/2026-08-18-v4-2392-tx-ip-config-t-handoff.md)
- **协作复盘**：[`docs/2026-08-18-v4-2392-tx-ip-prd-retrospect-internal-share.md`](../2026-08-18-v4-2392-tx-ip-prd-retrospect-internal-share.md)

## 9. 路由与评审

- **Assignee**：Bonnie Zhou（Config-T，V3+V4）
- **Reviewer**：Trevor Yao（PM）／需求方 Matt McEwen
- **FYI**：Dave Hu（dev lead）· Jack Wu / renhu（平台号）· Edward Wu（LCD 端另拆单）
- **Jira 回复**：**本轮未发** —— owner 已在 Slack 两条线发过 summary 且 PRD 链接可从 Figma 文件直达（owner 2026-08-18 明确「Slack 不用补 PRD 链接，点击进去自然可以看到」）。若后续要在 V4-2392 留痕，按 memory `jira-reply-format` 走 ADF + accountId 真 mention。