# dou1

**Repository Path**: xyangge/dou1

## Basic Information

- **Project Name**: dou1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 《上一上你怕什麽》抖音小游戏

基于 Cocos Creator 3.8.x + TypeScript 开发的抖音小游戏项目。

## 项目简介

《上一上你怕什麽》是一款休闲攀登类小游戏，玩家通过点击屏幕控制角色扒台阶，挑战更高高度。游戏包含三大模式：闯关模式、无尽模式、好友挑战。

## 技术栈

- **引擎**: Cocos Creator 3.8.x
- **语言**: TypeScript
- **平台**: 抖音小游戏
- **存储**: 纯客户端本地存储（sys.localStorage）
- **排行榜**: 抖音官方托管数据 API

## 项目结构

```
assets/
├── scenes/              # 场景文件
│   ├── Startup.scene    # 启动页
│   ├── Home.scene       # 主菜单
│   ├── Game.scene       # 游戏场景
│   └── Settlement.scene # 结算页
├── scripts/
│   ├── framework/       # 底层框架
│   │   ├── Singleton.ts
│   │   ├── ObjectPool.ts
│   │   ├── AudioManager.ts
│   │   └── PlatformUtils.ts
│   ├── game/            # 核心玩法
│   │   ├── GameManager.ts
│   │   ├── PlayerCtrl.ts
│   │   ├── StepGenerator.ts
│   │   ├── JudgeSystem.ts
│   │   └── LevelConfig.ts
│   ├── ui/              # UI 管理
│   │   ├── UIManager.ts
│   │   ├── RankManager.ts
│   │   └── AdManager.ts
│   ├── data/            # 数据存储
│   │   └── LocalData.ts
│   └── scenes/          # 场景脚本
│       ├── StartupScene.ts
│       ├── HomeScene.ts
│       ├── GameScene.ts
│       └── SettlementScene.ts
└── resources/           # 动态加载资源
    ├── prefabs/         # 预制体
    ├── img/             # 图片资源
    └── audio/           # 音频资源
```

## 核心功能

### 1. 判定系统（JudgeSystem）
- Perfect/Good/Miss 时间窗口判定
- 连击计数与速度累乘
- 动态难度调整

### 2. 游戏模式
- **闯关模式**: 100 个固定关卡，星级评定
- **无尽模式**: 无限生成台阶，全球排行榜
- **好友挑战**: 生成战书图片分享

### 3. 数据管理（LocalData）
- 本地存档（最高分、段位、皮肤）
- 段位系统（青铜→王者）
- 皮肤解锁管理

### 4. 抖音 SDK 集成
- **排行榜**: tt.setImRankData / tt.getImRankList
- **广告**: 激励视频（复活）+ Banner
- **分享**: 战书分享（含降级处理）
- **登录**: tt.login（隐私政策合规）

### 5. 平台适配
- PC/鸿蒙端降级处理
- 分享/广告 API 异常捕获
- 震动 API 兼容

## 快速开始

### 环境准备

1. 安装 Cocos Creator 3.8.x
2. 安装抖音开发者工具

### 运行项目

1. 使用 Cocos Creator 打开项目
2. 构建抖音小游戏平台
3. 在抖音开发者工具中预览

### 配置广告位

在 `AdManager.ts` 中修改广告位 ID：

```typescript
const AD_CONFIG = {
    REWARDED_VIDEO_ID: 'your_rewarded_video_ad_unit_id',
    BANNER_ID: 'your_banner_ad_unit_id'
};
```

## 核心玩法

### 操作方式
- 点击屏幕：角色扒台阶
- 判定窗口：Perfect（±50ms）/ Good（±150ms）/ Miss

### 难度曲线
- 台阶间距 = 基础间距 × (1 + 层数 × 0.015)
- 台阶宽度 = 基础宽度 × (1 - 层数 × 0.005)，最小 40px
- 移动速度 = 初始速度 × (1 + 层数 × 0.008)

### 连击特效
- 10 连击：缩放 +20%，拽哥/拽姐表情
- 20 连击：紫色火焰拖尾
- 50 连击：全屏闪白 + 变身

## 合规要点

1. **隐私政策**: 启动页必须显示隐私政策弹窗，同意前禁止调用 tt.login
2. **游戏名称**: UI 显示"上一上你怕什麽"（软著全称：上一上你怕什麽小游戏软件）
3. **敏感词过滤**: 战书文本需接入 tt.checkText 过滤
4. **广告降级**: PC/鸿蒙端隐藏广告按钮，引导截图分享

## 待办事项

- [ ] 创建场景文件（Startup、Home、Game、Settlement）
- [ ] 添加美术资源（角色、台阶、背景、特效）
- [ ] 添加音频资源（BGM、音效）
- [ ] 配置广告位 ID
- [ ] 测试抖音开发者工具
- [ ] 提交审核

## 开发规范

- 使用 ES2015 语法
- 添加 JSDoc 注释
- 使用 Cocos Creator 的 schedule/tween 替代 setInterval
- 所有 tt API 调用必须 try-catch 包裹
- 零云服务依赖，纯客户端存储

## 许可证

本项目仅供学习和参考使用。

## 联系方式

如有问题，请提交 Issue 或联系开发者。