← 都来码 / Dolaima← 例程索引kotlin/app/breakout.kt▶ 在浏览器里试玩 原文

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")
}