项目需求规格分析

队员信息

队员	学号
叶尚文（队长）	3116008802
蔡晓晴	3216008808
杜婷萱	3216008809
龙剑初	3116004647
于泽浩	3116004661

项目背景：

近年来音乐游戏层出不穷，其中不乏创新性作品，我们产品将面向爱好音游及RPG游戏的玩家，结合两者的特点开发一款游戏。

真实性：

目前市场上还不停地有各种各样的音游出现，音游实际上是能

给玩家一种体验还没接触过的乐器，或者作为练习某种乐器的

一种途径。所以说音游具有市场的真实性

可行性：

该游戏在显示上主要有有钢琴的乐谱和冒险“跑酷”两部分，听

觉上是玩家通过按下琴键发出的旋律，两者结合后，玩家可在

钢琴跑酷这个游戏中通过“键盘式琴键”可以有很好的体验效果，

同时玩家可以通过乐谱和游戏中的主人公来更好地掌握节奏。

玩家可以在学习的同时体验游戏的乐趣，很大程度避免了学习

的枯燥和游戏的单一性。

价值性：

“游戏+教育”已经逐渐成为社会的发展趋势。游戏不再像以前那

样是为了玩乐的片面产品，很多游戏慢慢转向职业化、多功能化，

其中从游戏中学习是最大的市场趋势。钢琴跑酷这个游戏避免了

市场上很多体验效果较差和功能单一的产品，把游戏和学习较好

地结合在一起。市场上还不断有音游的产品出现，说明音游有一

定的市场。钢琴跑酷这个游戏的最大卖点就是很好地把学习和完

结合在一起，很好地做到了“游戏+教育”。

项目需求：

用户需求：

体验效果好同时模仿操作相似的钢琴音游

摆脱传统音游的单一操作和单一视觉效果

在体验过程可以借助乐谱音符外的动态效果提示

借助游戏闯关效果来更好让玩家保持兴趣

功能需求：

一般需求：

实现高音区乐谱控制主人公跳跃跑图；

实现乐谱的规格化及提高可读性和可编辑性；

实现游戏画面整体可动。

高级需求：

实现低音区控制主人公的行为及动作；

实现用户向游戏自行导入乐谱。音乐以及对地图进行构建；

设置BOSS，根据乐谱和节奏设置QTE（Quick Time Event）操作。

后期改进需求：

实现游戏联网；

支持用户的乐谱和地图上传服务器并分享；

支持导入音乐自动生成对应的规格化乐谱并完成地图构建；

支持用户自行修改游戏贴图，改变风格。

环境需求：

使用语言：

H5（HTML + CSS + JavaScript）

开发软件：

Webstorm 或 Dreamweaver 等前端开发软件

heX（用于将HTML项目转化为.exe的桌面应用程序）

Photoshop（设计页面及元素）

技术需求：

团队要熟悉HTML,CSS,JAVAScript等语言

需同时对多个开发软件的操作熟悉

根据乐谱的音符生成游戏中不同的动态地图地形及障碍物

监听键盘输入指示，游戏中的冒险主人公要作出相应行为

团队分工：

程序构建及设计：叶尚文

根据需求构建整个程序的对象及函数关系，设计界面，制定DOM树和对应的元素设计

动态界面：龙剑初，于泽浩

读取乐谱文件，根据乐谱动态生成地图中的地形及障碍，怪物等。

静态界面：杜婷宣，蔡晓晴

读取组成界面的图片文件，构建静态UI的界面，并实现除游戏主界面外的欢迎页、介绍页等静态页面。

主人公控制及响应：叶尚文

监听键盘动作，根据键盘动作控制主人公行为；读取文件，根据文件判断行为是否正确，并给出相对应的反馈。

测试：于泽浩

测试各个阶段程序是否达到预期目标，并保证程序不会因乐谱文档的错误及数据量而出现严重崩溃。

任务简述：

实现视图:

事前说明：

开发过程中的测试请以heX的显示界面效果为准。

文件读取方式请参考项目内的player.js

文件说明：音乐为欢乐颂

第一行是速率（现在是2秒四小节（8个字符）），第二行开始是简谱，1,2及以下对应高度1，3,4对应高度2，5,6对应高度3，7,8及以上对应高度4。

背景要求：

使用给定图片，在限定的div里通过指定的css及js文件，完成如图背景和前景；

要求五线谱中间的判定线位置可调（调节参数用备注标明）；

背景每一张图片都可以独立循环向左移动播放，且移动速度可调（调节参数用备注标明）。

方块以及音符生成要求：

在限定的div里通过指定的css及js文件，读取给定的txt文件（规格化乐谱，路径：“../src/txt/test1.txt”），得出旋律和拍子时间，生成符合旋律高低的音符，字母以及方块，方块向上生成，然后向左移动，音符和字母从右渐显生成向左移动；

音符，字母及方块的移动速率可调，并可调节延迟（两者参数请备注说明）；

方块的种类要根据旋律的种类创建：

0x0y：创建种类1的方块；

0x00000y：创建种类2，3的方块，并在中间的0处添加对应数量的种类4的方块；

0xy：循环创建种类5，6的方块。

实例效果：

动作及响应要求：

主人公还没画好，不放图了。。。。

在限定的div里通过指定的css及js文件，读取给定的txt文件（规格化乐谱，路径：“../src/txt/test1.txt”），得出旋律和拍子时间，根据时间及旋律计算得出当前状态；

判定区示意图：

编码规则：

命名：

尽量遵循驼峰原则命名，并在声明时备注作用（如必要）

用于循环、记录状态、暂存的变量请用loop，state， temp开头并加上编号（编号计算以函数为单位）或者说明（如必要）

括号：

大括号内为空前面和内部都不用换行，否则：

左大括号前不换行，后换行；

右大括号前换行，后除规定语句块（else， while等）外换行；

连续同种小括号间空格。

符号：

各类运算符或判断符前后都有空格；

逗号后带空格。

字数：

每行不超过（111 - 11）字符，如超过：

从100字符内的最后空格开始换行；

若是运算符的空格则从运算符前的空格开始换行；

换行后在上一行换行处备注 ”//next line“。

缩进：

用4个空格，tab键请设置为4个空格。

其他：

if/for/while/switch/do等保留字与左右括号之间都必须加空格；

除判断及for/while等外，一行一个语句；

函数中，实现不同小功能的语句块之间空行，语句块内不空行，如必要在语句块前加上备注说明，例：

int a；

int b；

int temp

for（。。。）{

。。。

//交换a，b的值

temp = a；

a = b；

b = temp；

}

while 。。。

函数前请务必说明函数功能，若复杂请文档注释说明大概思路。

 

项目安排：

 原安排表：

第6周	1.团队组队、团队博客（✔）
	2.团队介绍、成员展示、角色分配、选题确定（✔）
	3.制定团队计划安排（✔）
第7周	1.需求规格说明书（✔）
	2.原型设计，队员估计任务难度并学习必要的技术（✔）
	3.编码规范完成、平台环境搭建完成、初步架构搭建（✔）
第8周	1.原型改进（给目标用户展现原型，并进一步理解需求）
	2.架构设计，WBS, 团队成员估计各自任务所需时间
	3.测试计划
第9周	1. 团队项目Alpha任务分配计划
	2. 连续7天的Alpha敏捷冲刺，7 篇 每日Scrum Meeting博客+代码提交
第10周	1.用户反馈+测试计划改进
	2. 团队Alpha阶段个人总结
	3. 团队项目Alpha博客：发布说明、测试报告、展示博客、项目管理
第11周	1. 团队项目Alpha博客：事后分析
	2. 每个团队有一人必须离开，自己寻找下一个接纳自己的团队。团队发博客宣布离队和接纳的成员。
第12周	1. 团队项目Beta任务分配计划，介绍新成员
	2. 连续7天的Beta敏捷冲刺，7 篇 每日Scrum Meeting博客+代码提交
第13周	1. 团队项目Beta博客：发布说明、测试报告、展示博客
	2. 团队Beta阶段个人总结
第14周	1. 团队项目Beta博客：事后分析， 宣布每人的贡献分
第15周	1.团队整个阶段总结，分析用户数据，整理文档，保证以后的团队能接手。

校正后安排：

第8周	初步实现各个模块原始界面效果，合并代码后寻找不足并改进，以尽量避免后续功能实现的代码产生不兼容情况
第9周	制定Alpha计划，搭建整体框架，实现各模块功能并合并
第10周	对各个功能模块进行测试，让用户试用并通过反馈进行改进
第11周	总结收获和不足，团队调整
第12周~~	依情况从新规划

校正方法：

刚开始的规划还没有对项目进行深入的解剖和分析，很多安排都没能很好地按计划完成。

因为本次项目用到的编程语言并不是都会，所以经过分析后，主要的功能和测试放在了第

10和11周两周，在各模块功能完成时就可以进行初步的测试，等预期功能都实现的时候，

再进行统一的整体测试，这样就可以把最终测试出现的不足很好地锁定。

队员感想：

叶尚文：第一次开发自己创造的游戏，有点兴奋又有点紧张。第一次带领队伍，第一次5人的

团队合作，我希望能带领好这个团队。也希望在这个过程中提升自身的领导能力，同时

从中找到自己的不足。

蔡晓晴：这个星期还没有开始写代码，但是叶尚文大佬给了我们一个清晰的架构和代码标准，

十分利于我们后期打代码。这个星期我也学习了很多js的知识。

杜婷萱：感觉开发前的充分沟通，明确的任务分工很重要。我和晓晴共同完成静态背景的实现，

但js刚开始学接触的还不是很多(°ー°〃)因此要向团队多多请教，希望能通过这次的项

目学到更多的知识 (*^▽^*)

龙剑初：在这一周里，团队对项目进行了进一步的探索和理解，在队长尚文大佬的带领下，我

们把项目的主要功能模块和大致的架构做了初步的确定，同时进行了任务的分配。项

目要用到js和css等还没接触过的语言，这对于我来说是个极大的挑战。自知代码能力

不强，但也会尽力。接下来好好努力，跟着大佬们学习。

于泽浩：和同学一起团队协作，每个人都有每个人的长处，让我认识到了自己太多需要学习，

但是团队协作依靠的也不只是每个人的能力，清晰的统筹才能一步步将计划完成。非

常期待接下来一步步将计划完成。