# TVDisplay

**Repository Path**: simpleComplicated2022/tvdisplay

## Basic Information

- **Project Name**: TVDisplay
- **Description**: 电视显示 大屏，可以接收电脑发送的文字和图片
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📺 TV Display - Android TV 投屏显示应用

一个 Android TV 应用，接收电脑通过局域网发送的文字和图片，全屏显示在电视上。

## 功能

- ✅ 接收并全屏显示文字（支持中文、多行）
- ✅ 接收并全屏显示图片（JPG/PNG/GIF/WebP）
- ✅ 电视端自动显示局域网 IP 地址
- ✅ 电脑端通过浏览器发送，无需安装软件
- ✅ 支持 Android 11 (API 30) 及以上电视系统
- ✅ 遥控器操作，按「返回」键退出全屏

## 项目结构

```
tv-display/
├── app/                              # 电视端 Android 应用
│   ├── build.gradle.kts             # App 模块构建配置
│   ├── proguard-rules.pro
│   └── src/main/
│       ├── AndroidManifest.xml       # 应用清单
│       ├── java/com/example/tvdisplay/
│       │   ├── MainActivity.kt       # 主界面 + 全屏显示
│       │   ├── WebServer.kt          # HTTP 服务器（NanoHTTPD）
│       │   └── NetworkUtils.kt       # 获取本机 IP
│       └── res/
│           ├── layout/activity_main.xml  # 界面布局
│           ├── values/               # 颜色、字符串、主题
│           ├── drawable/             # 图标、形状
│           └── mipmap-anydpi-v26/    # 启动图标
├── sender/
│   └── index.html                    # 电脑端发送页面（浏览器打开即可）
├── build.gradle.kts                  # 根构建配置
├── settings.gradle.kts
├── gradle.properties
└── gradle/wrapper/gradle-wrapper.properties
```

## 构建 APK 步骤

### 方法一：Gitee 云端编译（国内推荐，速度快）

> ✨ 用码云 Gitee Go，国内访问飞速，本地零配置。

详细操作步骤见 **[GITEE_BUILD.md](GITEE_BUILD.md)**，简要流程：
1. 注册 Gitee 并开通 Gitee Go
2. 创建仓库，上传项目文件
3. Gitee Go 自动编译（约 5-10 分钟）
4. 在制品页面下载 APK

### 方法二：GitHub 云端编译

> 适合有 GitHub 账号的用户，同样零配置。

详细步骤见 **[CLOUD_BUILD.md](CLOUD_BUILD.md)**。

### 方法三：Android Studio 本地编译

1. **下载安装 Android Studio**
   - 官网：https://developer.android.com/studio
   - 安装时勾选 Android SDK

2. **打开项目**
   - 启动 Android Studio → `File` → `Open`
   - 选择 `tv-display` 文件夹
   - 等待 Gradle 同步完成（首次会自动下载依赖）

3. **构建 APK**
   - 菜单栏：`Build` → `Build Bundle(s) / APK(s)` → `Build APK(s)`
   - 等待构建完成，点击通知栏的 `locate` 找到 APK
   - APK 路径：`app/build/outputs/apk/debug/app-debug.apk`

### 方法四：命令行本地编译

```bash
# 安装 Android SDK 和 gradle 后执行
cd tv-display
gradlew assembleDebug
# APK 生成在 app/build/outputs/apk/debug/app-debug.apk
```

## 安装到电视

### 方法一：U盘安装

1. 将 `app-debug.apk` 复制到 U盘
2. U盘插入电视
3. 用电视文件管理器找到 APK，点击安装
4. 如提示「未知来源」，在设置中允许安装

### 方法二：ADB 安装

```bash
# 1. 电视开启开发者模式（设置 → 关于 → 连续点击版本号7次）
# 2. 电视开启 USB 调试
# 3. 电脑执行：
adb connect <电视IP>:5555
adb install app-debug.apk
```

## 使用方法

### 1. 电视端

- 打开 TV Display 应用
- 屏幕显示局域网地址，例如 `http://192.168.1.100:8080`
- 保持应用在前台运行

### 2. 电脑端

- 用浏览器打开 `sender/index.html`
- 输入电视上显示的 IP 地址
- 发送文字或图片
- 电视自动全屏显示

### 3. 网络要求

- 电脑和电视连接**同一个 WiFi / 局域网**
- 电视防火墙允许 8080 端口访问

## 工作原理

```
┌─────────────┐        HTTP POST          ┌─────────────┐
│   电脑端     │  ────(局域网 WiFi)────▶   │   电视端     │
│  浏览器页面  │                           │  TV Display │
│ index.html  │  ◀────状态响应──────────   │   (APK)     │
└─────────────┘                           └─────────────┘
```

- 电视端内置 HTTP 服务器（NanoHTTPD），监听 8080 端口
- 电脑端通过浏览器发送 POST 请求
- `POST /text` → 发送文字
- `POST /image` → 发送图片（multipart 或 base64）
- 电视收到后自动全屏显示

## 技术参数

| 项目 | 值 |
|------|-----|
| 最低系统 | Android 11 (API 30) |
| 目标系统 | Android 14 (API 34) |
| 语言 | Kotlin |
| HTTP 库 | NanoHTTPD 2.3.1 |
| 屏幕方向 | 横屏（Landscape） |
| 默认端口 | 8080（自动查找可用端口） |