Script字节跳动小游戏

### 字节跳动小游戏 Script 开发教程

#### 小游戏环境搭建
为了创建字节跳动的小游戏项目，开发者需先安装并配置好开发工具。推荐使用官方提供的字节跳动轻应用IDE来构建和调试小游戏。

#### 初始化项目结构
建立一个新的小游戏工程通常涉及几个基础文件夹与文件：

- `pages/` 存放页面逻辑代码及相关资源；
- `components/` 自定义组件存放位置；
- `utils/` 工具函数集合；
- `app.js` 应用启动入口文件；
- `game.json` 游戏全局配置文件；

#### 关键API介绍

##### 操作闪光灯功能实现
通过调用特定接口可以控制设备摄像头的闪光灯开关状态，在某些场景下可能用于增强用户体验或辅助拍摄效果。具体方法如下所示[^1]:

// 打开或关闭闪光灯
function toggleFlashlight(status) {
    tt.setFlash({
        flash: status, // true 或 false 控制开启与否
        success(res) { console.log('操作成功:', res); },
        fail(err) { console.error('操作失败:', err); }
    });
}

此处展示了如何利用tt对象下的setFlash() API 来切换手机相机LED补光灯的状态，并处理相应的回调结果。

##### 处理扫描二维码事件
当涉及到读取条形码或QR Code时，可以通过监听特定事件获取解析后的信息。下面是一个简单的例子展示怎样捕获扫码完成的通知以及其携带的数据参数:

Page({
    onLoad(query) {},
    
    onReady() {
        const that = this;
        
        wx.scanCode({
            onlyFromCamera: true,
            success(res){
                if (res.result) {
                    let data = JSON.parse(res.result);
                    
                    that.setData({
                        scanResult: `${data.message} (${data.type})`,
                        imagePath: data.file || ''
                    });

                    console.info(`识别成功`, res);
                } else {
                    console.warn('未检测到有效内容');
                }
            },
            fail(error){
                console.error('发生错误', error);
            }
        })
    },

    marked(e) {
        console.log('接收到标记消息:', e.detail);
    },

    error(e) {
        console.error('遇到问题:', e.detail);
    }
});

上述片段中包含了对于`marked()` 和 `error()` 方法的具体运用方式，它们分别用来接收来自底层框架关于图像内目标物被正确标注或是过程出现问题的信息反馈。