kotlin/app/breakout.kt · 18251 字节 · 下载原文
// 打砖块 —— 用 **Kotlin** 写的手机小游戏
// Breakout — a small phone game written in **Kotlin**
//
// 玩法:手指左右滑动(或按方向键)移动挡板,把球弹回去打碎上面的砖块;球掉下去就少一条命,
// Gameplay: slide a finger (or use the arrow keys) to move the paddle and bounce the ball into
// 三条命用完就结束。打光所有砖块即过关。点一下/空格发球,ESC 退出。
// the bricks above. A dropped ball costs one of three lives; losing all three ends the run.
// Clearing every brick wins. Tap/Space serves, ESC quits.
//
// ◆ 这个示例的重点:**墙钟补步 + 整数物理 + 命中优先级**
// ◆ What this sample focuses on: **wall-clock stepping + integer physics + collision priority**
//
// ① 定时器只负责唤醒;每帧该走几步 = 已经过去的毫秒数 ÷ 每步毫秒数(用户 2026-10-04 口径)。
// ① The timer only wakes the loop; steps per frame = elapsed milliseconds / milliseconds per step
// (user rule of 2026-10-04)。
// ② 位置与速度都是「像素 ×10」的整数 —— 结果完全可复现,demo 模式的判据就靠这一点。
// ② Positions and velocities are integers in "pixels x10" — fully reproducible, which is what the
// demo checkpoints rely on.
// ③ 一步之内先判墙、再判挡板、最后判砖块:球与挡板同高时不会被砖块抢走。
// ③ Within one step: walls first, then the paddle, then the bricks — so a ball level with the
// paddle cannot have its bounce stolen by a brick.
//
// 数值的唯一真源仍是 `Lib/c/vml_ui.h`。
// The single source of truth for these numbers is still `Lib/c/vml_ui.h`.
//
// 跑法:手机 `vml run examples/kotlin/app/breakout.kt`;
// How to run: phone `vml run examples/kotlin/app/breakout.kt`;
// 桌面 `vmlcli Examples/kotlin/app/breakout.kt --screen 411x726 --frames /tmp/fr`
// desktop `vmlcli Examples/kotlin/app/breakout.kt --screen 411x726 --frames /tmp/fr`
// `--arg demo` 是无头验收模式:三段固定物理 + 80 拍渲染后自己退出。
// `--arg demo` is the headless acceptance mode: three fixed physics checks + 80 rendered ticks, then exit.
#include <vml_ui.kt>
import vmlui.*
// ── 规则 ──
// ── Rules ──
const val COLS = 7
const val BROWS = 5
const val MAXB = COLS * BROWS
const val TICK_MS = 16
const val BALL_R = 7
const val PADDLE_H = 14
const val PADDLE_STEP = 8
const val START_LIVES = 3
// ── 消息类型 / 键码(源:Lib/c/vml_ui.h)──
// ── Message types / key codes (source: Lib/c/vml_ui.h) ──
const val MSG_KEYDOWN = 1
const val MSG_MOUSEDOWN = 4
const val MSG_TOUCHDOWN = 6
const val MSG_TOUCHMOVE = 7
const val MSG_TOUCHUP = 8
const val MSG_TIMER = 9
const val MSG_CLOSE = 10
const val MSG_RESIZE = 11
const val MSG_ORIENT = 12
const val KEY_ESCAPE = 27
const val KEY_ENTER = 13
const val KEY_SPACE = 32
const val KEY_LEFT = 37
const val KEY_UP = 38
const val KEY_RIGHT = 39
const val KEY_DOWN = 40
const val ANCHOR_LEFT = 0
const val ANCHOR_CENTER = 1
const val ANCHOR_RIGHT = 2
// ── 配色:0xAARRGGBB 直接写(Kotlin 前端支持十六进制字面量)──
// ── Colors: 0xAARRGGBB literals (the Kotlin front end accepts hex) ──
const val C_BG = 0xFF101018
const val C_COURT = 0xFF1A1A24
const val C_LINE = 0xFF3C3C4C
const val C_TEXT = 0xFFE8E8F0
const val C_MUTED = 0xFF9AA0B0
const val C_PADDLE = 0xFF51E86E
const val C_BALL = 0xFFFFE060
const val C_GOLD = 0xFFFFC040
const val C_RED = 0xFFE06050
const val C_SCRIM = 0xCC000000
const val B0 = 0xFF4A90D9
const val B1 = 0xFF95A5B3
const val B2 = 0xFFD9B44A
const val B3 = 0xFFE06C50
const val B4 = 0xFF8B5CF6
// ── 状态 ──
// ── State ──
var SW = 0
var SH = 0
var LANG = 0
// 矮屏(240x240 一类)用压缩排版
// Compact layout flag for short screens (240x240 etc.)
var COMPACT = 0
var S = IntArray(MAXB) // 1 = 这块砖还在
// 1 = this brick is still standing
var bricksLeft = 0
var score = 0
var lives = START_LIVES
var gameState = 0 // 0 = 待发球 1 = 进行中 2 = 过关 3 = 结束
// 0 = awaiting serve, 1 = playing, 2 = cleared, 3 = over
var hits = 0 // 挡板回球次数(demo 判据)
// paddle returns (a demo checkpoint)
var wallBounces = 0
var frames = 0
var frameLimit = 0
var BX = 0
var BY = 0
var BW = 0
var BH = 0
var PX = 0
var PY = 0
var PW = 0
var ballX10 = 0
var ballY10 = 0
var vx10 = 0
var vy10 = 0
var touchX = 0
var touchDown = 0
var acc = 0
var lastMs = 0
fun T(zh: String, en: String): String {
if (LANG == 0) { return zh }
return en
}
fun clamp(v: Int, lo: Int, hi: Int): Int {
if (v < lo) { return lo }
if (v > hi) { return hi }
return v
}
fun absI(v: Int): Int {
if (v < 0) { return 0 - v }
return v
}
// ── 排版:全部由屏宽屏高推出来 ──
// ── Layout: all derived from the screen size ──
fun layout() {
COMPACT = 0
BW = (SW - 24) / COLS
BH = 20
BX = (SW - BW * COLS) / 2
BY = 104
if (SH < 420) {
COMPACT = 1
// 矮屏:砖块从墙下方开始,扣掉挡板/提示区后按剩余高度定砖高
// Short screens: bricks start below the wall, and their height comes from what is left
// above the paddle/hint area
BY = 74
BH = (SH - BY - 84) / BROWS
if (BH < 10) { BH = 10 }
if (BH > 20) { BH = 20 }
}
PW = SW / 3
if (PW < 96) { PW = 96 }
if (PW > SW - 40) { PW = SW - 40 }
PX = clamp(PX, 8, SW - 8 - PW)
PY = SH - 78
if (touchDown != 0) { PX = clamp(touchX - PW / 2, 8, SW - 8 - PW) }
}
fun brickColor(r: Int): Int {
if (r == 0) { return B0 }
if (r == 1) { return B1 }
if (r == 2) { return B2 }
if (r == 3) { return B3 }
return B4
}
// ── 开局 / 发球 ──
// ── New game / serve ──
fun newGame() {
var i = 0
while (i < MAXB) { S[i] = 1; i = i + 1 }
bricksLeft = MAXB
score = 0
lives = START_LIVES
hits = 0
wallBounces = 0
gameState = 0
resetBall()
}
fun resetBall() {
ballX10 = (PX + PW / 2) * 10
ballY10 = (PY - BALL_R - 4) * 10
vx10 = 0
vy10 = 0
}
fun launch() {
if (gameState == 0) {
vx10 = 28
vy10 = 0 - 52
gameState = 1
ui_audio_beep(660, 40)
}
}
// ── 一次物理步进;返回 0 = 无事,1 = 墙,2 = 挡板,3 = 砖块,4 = 掉球 ──
// ── One physics step; returns 0 = nothing, 1 = wall, 2 = paddle, 3 = brick, 4 = lost ball ──
fun tick(): Int {
if (gameState != 1) {
// 待发球时球跟着挡板走
// While awaiting a serve the ball rides on the paddle
ballX10 = (PX + PW / 2) * 10
ballY10 = (PY - BALL_R - 4) * 10
return 0
}
ballX10 = ballX10 + vx10
ballY10 = ballY10 + vy10
var ev = 0
// ① 墙
// (1) Walls
var left10 = (8 + BALL_R) * 10
var right10 = (SW - 8 - BALL_R) * 10
var top10 = (66 + BALL_R) * 10
if (ballX10 < left10) { ballX10 = left10; vx10 = 0 - vx10; ev = 1 }
if (ballX10 > right10) { ballX10 = right10; vx10 = 0 - vx10; ev = 1 }
if (ballY10 < top10) { ballY10 = top10; vy10 = 0 - vy10; ev = 1 }
if (ev == 1) { wallBounces = wallBounces + 1 }
// ② 挡板(只在球往下落时判,避免从背面吸住)
// (2) Paddle (only while the ball is falling, so it cannot stick from behind)
if (vy10 > 0) {
var by = ballY10 / 10
var bx = ballX10 / 10
if (by + BALL_R >= PY && by - BALL_R <= PY + PADDLE_H) {
if (bx + BALL_R >= PX && bx - BALL_R <= PX + PW) {
ballY10 = (PY - BALL_R) * 10
vy10 = 0 - absI(vy10)
if (vy10 > -40) { vy10 = -46 }
// 击球点决定水平分量
// where it hits sets the horizontal component
var rel = bx - (PX + PW / 2)
vx10 = clamp(rel * 3, -70, 70)
hits = hits + 1
ev = 2
}
}
}
// ③ 砖块(球用"外接方框"与砖块矩形相交)
// (3) Bricks (the ball's bounding box against each brick rectangle)
var bi = 0
while (bi < MAXB) {
if (S[bi] != 0) {
var r = bi / COLS
var c = bi % COLS
var x0 = BX + c * BW
var y0 = BY + r * BH
var bx2 = ballX10 / 10
var by2 = ballY10 / 10
if (bx2 + BALL_R >= x0 && bx2 - BALL_R <= x0 + BW - 2) {
if (by2 + BALL_R >= y0 && by2 - BALL_R <= y0 + BH - 2) {
S[bi] = 0
bricksLeft = bricksLeft - 1
score = score + 10
vy10 = 0 - vy10
var newBy = 0
if (vy10 < 0) { newBy = (y0 - BALL_R - 1) * 10 } else { newBy = (y0 + BH + BALL_R + 1) * 10 }
ballY10 = newBy
ev = 3
if (bricksLeft == 0) { gameState = 2; ui_audio_beep(1047, 220) }
bi = MAXB
}
}
}
bi = bi + 1
}
// ④ 掉出屏幕
// (4) Fell off the bottom
if (ballY10 > (SH + 10) * 10 && gameState == 1) {
lives = lives - 1
ev = 4
if (lives <= 0) {
gameState = 3
ui_audio_beep(131, 320)
} else {
gameState = 0
resetBall()
ui_audio_beep(220, 160)
}
}
return ev
}
// ── 绘制 ──
// ── Drawing ──
fun draw() {
ui_2d_clear(C_BG)
ui_2d_rect(6, 62, SW - 12, SH - 62 - 8, C_COURT, 1, 0, 12)
// HUD:得分 / 命 / 剩砖
// HUD: score / lives / bricks left
var hudFs = 16
var hudFs2 = 14
if (COMPACT == 1) { hudFs = 13; hudFs2 = 11 }
ui_2d_text(14, 26, T("得分 ", "Score ") + score, C_GOLD, hudFs, ANCHOR_LEFT)
ui_2d_text(SW / 2, 26, T("命 ", "Lives ") + lives, C_TEXT, hudFs, ANCHOR_CENTER)
ui_2d_text(SW - 14, 26, T("剩 ", "Left ") + bricksLeft, C_MUTED, hudFs2, ANCHOR_RIGHT)
// 砖块
// Bricks
var i = 0
while (i < MAXB) {
if (S[i] != 0) {
var r = i / COLS
var c = i % COLS
ui_2d_rect(BX + c * BW + 1, BY + r * BH + 1, BW - 3, BH - 3, brickColor(r), 1, 0, 4)
}
i = i + 1
}
// 挡板与球
// Paddle and ball
ui_2d_rect(PX, PY, PW, PADDLE_H, C_PADDLE, 1, 0, 6)
ui_2d_circle(ballX10 / 10, ballY10 / 10, BALL_R, C_BALL, 1, 0)
if (gameState == 0) {
// 矮屏上屏幕正中落在砖块区里,把"发球"提示挪到挡板上方
// On short screens the screen centre lands inside the bricks, so put the serve hint above the paddle
var serveY = SH / 2
var serveFs = 15
if (COMPACT == 1) { serveY = SH - 38; serveFs = 12 }
ui_2d_text(SW / 2, serveY, T("点一下 / 空格发球", "Tap / Space to serve"), C_MUTED, serveFs, ANCHOR_CENTER)
}
var overTitleFs = 28
var overScoreFs = 18
var overHintFs = 13
if (COMPACT == 1) { overTitleFs = 22; overScoreFs = 15; overHintFs = 11 }
if (gameState == 2) {
ui_2d_rect(0, 0, SW, SH, C_SCRIM, 1, 0, 0)
ui_2d_text(SW / 2, SH / 2 - 20, T("全部打碎!", "All cleared!"), C_PADDLE, overTitleFs, ANCHOR_CENTER)
ui_2d_text(SW / 2, SH / 2 + 18, T("得分 ", "Score ") + score, C_GOLD, overScoreFs, ANCHOR_CENTER)
ui_2d_text(SW / 2, SH / 2 + 48, T("点任意处再来一局", "Tap anywhere for another round"), C_MUTED, overHintFs, ANCHOR_CENTER)
}
if (gameState == 3) {
ui_2d_rect(0, 0, SW, SH, C_SCRIM, 1, 0, 0)
ui_2d_text(SW / 2, SH / 2 - 20, T("游戏结束", "Game over"), C_RED, overTitleFs, ANCHOR_CENTER)
ui_2d_text(SW / 2, SH / 2 + 18, T("得分 ", "Score ") + score, C_GOLD, overScoreFs, ANCHOR_CENTER)
ui_2d_text(SW / 2, SH / 2 + 48, T("回车 / 点任意处重开", "Enter / tap anywhere to restart"), C_MUTED, overHintFs, ANCHOR_CENTER)
}
// 矮屏换成短提示(长句在 240 宽上会被裁)
// Short hint on short screens (the long line gets clipped at 240 px wide)
if (COMPACT == 1) {
ui_2d_text(SW / 2, SH - 14, T("滑动移动挡板 · ESC 退出", "Slide · ESC quits"), C_MUTED, 10, ANCHOR_CENTER)
} else {
ui_2d_text(SW / 2, SH - 18, T("滑动 / 方向键移动挡板 · ESC 退出", "Slide / arrows move the paddle · ESC quits"), C_MUTED, 11, ANCHOR_CENTER)
}
ui_2d_present()
}
// ── 无头验收:三段固定物理(结果完全可复现)──
// ── Headless acceptance: three fixed physics checks (fully reproducible) ──
fun demoChecks() {
var i = 0
var ev = 0
// ① 上墙:球贴顶向上飞 ⇒ 一步之后 vy 变号
// (1) Top wall: the ball hugs the top going up ⇒ vy flips sign after one step
newGame()
gameState = 1
ballX10 = SW * 5
ballY10 = (66 + BALL_R + 2) * 10
vx10 = 0
vy10 = -30
tick()
println("brk: wall=" + wallBounces + "/" + vy10)
// ② 挡板:球从正上方落下、挡板就在下面 ⇒ 必须弹起(vy < 0)
// (2) Paddle: the ball falls straight down onto the paddle ⇒ it must bounce (vy < 0)
newGame()
gameState = 1
PX = SW / 2 - PW / 2
ballX10 = (PX + PW / 2) * 10
ballY10 = (PY - 40) * 10
vx10 = 0
vy10 = 40
i = 0
while (i < 20 && hits == 0) { ev = tick(); i = i + 1 }
println("brk: paddle=" + hits + "/" + vy10)
// ③ 砖块:球从**最底下一行**(第 4 行)第 3 列砖块正下方往上飞 ⇒ 那块砖消失、得分 +10
// (3) Brick: the ball flies up from under the **bottom row** (row 4), column 3 ⇒ that brick goes
// away and the score gains 10. ⚠ 砖块是叠起来的:从下方只能先打到最底下那行。
// ⚠ Bricks are stacked: from below the ball can only reach the bottom row first.
newGame()
gameState = 1
var c = 3
var row = BROWS - 1
var slot = row * COLS + c
ballX10 = (BX + c * BW + BW / 2) * 10
ballY10 = (BY + row * BH + BH + BALL_R) * 10
vx10 = 0
vy10 = -40
ev = tick()
println("brk: brick=" + bricksLeft + "/" + score + "/" + S[slot])
}
fun main() {
var t = 0
var k = 0
var tid = 0
LANG = ui_scr_get_language()
if (ui_arg_get_count() > 1) { frameLimit = 80 }
ui_win_open_ex(T("打砖块", "Breakout"), 0, 0, VML_WIN_PORTRAIT, VML_WIN_NO_GAMEPAD)
ui_scr_lock_orientation(VML_LOCK_PORTRAIT)
ui_scr_set_keep_on(1)
SW = ui_scr_get_w()
SH = ui_scr_get_h()
if (SW <= 0) { SW = 411 }
if (SH <= 0) { SH = 726 }
PX = 0
layout()
PX = (SW - PW) / 2
if (frameLimit > 0) {
demoChecks()
newGame()
layout()
} else {
newGame()
}
draw()
tid = ui_timer_set(TICK_MS, 0)
acc = 0
lastMs = ui_time_get_ms()
while (ui_win_is_closed() == 0) {
t = ui_msg_fetch_wait(TICK_MS)
// 这一帧该走几步:按墙钟欠账(定时器分辨率各平台不同)
// Steps this frame: by wall-clock debt (timer resolution differs per platform)
var now2 = ui_time_get_ms()
acc = acc + (now2 - lastMs)
lastMs = now2
if (acc > TICK_MS * 8) { acc = 0 }
if (acc >= TICK_MS) {
while (acc >= TICK_MS) {
acc = acc - TICK_MS
frames = frames + 1
if (ui_key_is_down(KEY_LEFT) != 0) { PX = clamp(PX - PADDLE_STEP, 8, SW - 8 - PW) }
if (ui_key_is_down(KEY_RIGHT) != 0) { PX = clamp(PX + PADDLE_STEP, 8, SW - 8 - PW) }
var ev = tick()
// 一次事件只发一个音(ui_audio_beep 是单通道的)
// one sound per event (ui_audio_beep is single-channel)
if (ev == 1) { ui_audio_beep(520, 18) }
if (ev == 2) { ui_audio_beep(440, 30) }
if (ev == 3) { ui_audio_beep(880, 25) }
}
draw()
}
if (t == MSG_CLOSE) { break }
if (t == MSG_RESIZE || t == MSG_ORIENT) {
SW = ui_scr_get_w()
SH = ui_scr_get_h()
if (SW <= 0) { SW = 411 }
if (SH <= 0) { SH = 726 }
layout()
draw()
continue
}
if (t == MSG_KEYDOWN) {
k = ui_msg_get_a()
if (k == KEY_ESCAPE) { break }
if (k == KEY_SPACE || k == KEY_ENTER) {
if (gameState == 0) { launch() }
else if (gameState == 2 || gameState == 3) { newGame(); launch() }
draw()
}
continue
}
if (t == MSG_TOUCHDOWN || t == MSG_MOUSEDOWN) {
if (gameState == 2 || gameState == 3) {
newGame()
layout()
ui_audio_beep(523, 60)
} else {
touchDown = 1
touchX = ui_msg_get_a()
PX = clamp(touchX - PW / 2, 8, SW - 8 - PW)
launch()
}
draw()
continue
}
if (t == MSG_TOUCHMOVE) {
touchX = ui_msg_get_a()
PX = clamp(touchX - PW / 2, 8, SW - 8 - PW)
draw()
continue
}
if (t == MSG_TOUCHUP) {
touchDown = 0
continue
}
if (t == MSG_TIMER) {
// 定时器只负责唤醒(推进在上面按墙钟欠账走)
// The timer only wakes the loop (advance happens above, by wall-clock debt)
if (frameLimit > 0 && frames >= frameLimit) { break }
continue
}
}
ui_timer_kill(tid)
ui_scr_set_keep_on(0)
ui_win_close()
// 给无头验证留确定性判据
// Deterministic checkpoints for headless verification
println("brk: score-final=" + score)
println("brk: bricks-final=" + bricksLeft)
println("brk: lives=" + lives)
println("brk: state=" + gameState)
println("brk: frames=" + frames)
println("brk: done")
}