# 宠物智能电视互动娱乐系统

**Repository Path**: ufohacker/PetTV

## Basic Information

- **Project Name**: 宠物智能电视互动娱乐系统
- **Description**: PetTV 是一套面向宠物行业的智能电视互动娱乐系统。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-07-19
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PetTV 项目说明

## 项目简介

**PetTV** 是一套面向宠物行业的智能电视互动娱乐系统。演示地址：http://39.96.174.229/  
- **Server目录**：后端服务，负责用户、设备、视频、消息等数据的管理与交互。
- **Android目录**：Android TV 客户端，提供宠物视频播放、互动控制、实时消息等功能。

> ⚠️ 由于涉及商业版权，部分核心代码暂未开源，仅开放部分接口和实现思路，敬请谅解。

---

## 主要功能

### PetVC（后端）

- 用户注册、登录与鉴权（JWT）
- 设备管理（绑定、编辑、心跳检测）
- 视频内容管理与推荐
- 消息推送与实时互动
- 统计与数据分析
- RESTful API 及 WebSocket 实时通信

### PetTV（Android TV端）

- 电视端用户登录与设备绑定
- 高清宠物视频点播与推荐
- 实时弹幕、点赞、互动消息
- 远程遥控与设置
- 设备状态实时反馈

---

## 核心实现原理

### 1. 用户与设备体系

- 用户注册后可绑定多台电视设备，每台设备有唯一 `device_id`（Android 端基于设备唯一标识生成，便于后端识别和管理）。
- 设备心跳机制，定期上报状态，后端实时监控设备在线情况。

### 2. 视频内容与推荐

- 视频内容存储于后端数据库，支持分类、标签、推荐算法。
- 前端通过 RESTful API 获取视频列表、详情及推荐内容。

### 3. 实时消息与互动

- 采用 WebSocket 技术实现电视端与后端的实时通信。
- 支持弹幕、点赞、互动消息等功能，提升用户参与感。
- 后端消息服务模块负责消息分发与状态同步。

### 4. 安全与权限

- 用户鉴权采用 JWT（JSON Web Token），接口安全可靠。
- 设备与用户操作均有权限校验，防止未授权访问。

### 5. 统计与数据分析

- 后端定期收集设备活跃、视频播放、用户行为等数据。
- 支持数据可视化与运营分析（部分功能为商业闭源）。

---

## 技术栈

- **后端（PetVC）**：Python 3、Flask、SQLite、Socket.IO、JWT
- **前端（PetTV）**：Kotlin、Android TV、WebSocket、RESTful API
- **数据库**：SQLite（可扩展为 MySQL/PostgreSQL）
- **前端页面**：HTML5、Tailwind CSS、ECharts

---

## 目录结构说明

```text
Server/
  ├── app.py                  # 后端主入口
  ├── models/                 # 数据库模型
  ├── routes/                 # 路由与接口
  ├── services/               # 业务逻辑与服务
  ├── utils/                  # 工具类与辅助函数
  ├── static/                 # 静态资源
  ├── templates/              # 前端模板
  └── requirements.txt        # Python依赖

Android/
  ├── app/                    # Android TV主程序
  ├── res/                    # 资源文件（图片、布局等）
  ├── build.gradle.kts        # 构建脚本
  └── ...                     # 其他配置与资源
```

---

## 快速开始

> ⚠️ 由于部分代码未开源，以下为体验版部署流程，仅供参考。

### 后端（PetVC）

1. 安装依赖  
   ```bash
   pip install -r requirements.txt
   ```
2. 启动服务  
   ```bash
   python app.py
   ```

### 电视端（PetTV）

1. 使用 Android Studio 打开 `Android/app` 目录
2. 配置后端 API 地址（见 `ApiConfig.kt`）
3. 编译并部署到 Android TV 设备

---

## 商业版权声明

本项目部分核心代码、算法及资源涉及商业版权，暂不对外开源。  
如需合作或定制开发，请联系我。

---

## 联系方式

- 邮箱：ufohacker@foxmail.com
- 微信：ufohacker

![输入图片说明](wechat.jpg)
---

## 致谢

感谢所有为本项目做出贡献的开发者与合作伙伴！

---

如需进一步了解或体验完整功能，欢迎联系我们获取商业授权或演示版本。