LeviosaSDK应用功能演示

引入SDK文件

在HTML文件中引入Leviosa SDK脚本：

<script src="leviosa-sdk.js"></script>

初始化SDK实例

使用配置选项创建SDK实例并初始化：

注意：蓝牙配置（服务UUID、特征值UUID、支持的设备、命令库）现已固定在SDK内部，不再支持通过配置选项自定义。SDK默认支持Accio、Aogu、Sam Neo等设备，如需支持其他设备请修改SDK源代码。

const sdk = new LeviosaSDK({
    // 基本配置
    targetElement: '#app',
    debug: true,
    videoSelector: '.video-monitor-target',
    showVideoNotifications: true,

    // 浮标控制（默认启用）
    floatingControls: true,

    // 模拟模式（无真实蓝牙设备时使用）
    simulateBluetooth: true,

    // 视频指令JSON文件的基础路径
    videoCommandBasePath: '/data'
});

sdk.init().then(success => {
    console.log('SDK初始化:', success ? '成功' : '失败');

    // 监听SDK事件
    sdk.on('videoCommand', (event) => {
        console.log(`视频指令触发: ${event.detail.videoId} 在 ${event.detail.time}秒`);
    });

    sdk.on('bluetoothConnected', () => {
        console.log('蓝牙设备已连接');
    });

    sdk.on('bluetoothDisconnected', () => {
        console.log('蓝牙设备已断开');
    });
});

添加视频到播放列表

添加视频并关联指令配置文件：

sdk.addVideo({
    src: 'videos/sample.mp4',
    title: '示例视频',
    description: '带有时间点指令的视频',
    jsonPath: '/data/sample.json' // 指令配置文件路径
});

指令配置文件示例 (sample.json):

[
    {
        "t": 3.2,  // 时间点（秒）
        "cmd": "510800000304"  // 蓝牙指令
    },
    {
        "t": 9.2,
        "cmd": "510800000508"
    },
    {
        "t": 15.7,
        "cmd": "510800000712"
    }
]

连接蓝牙设备

调用连接方法并监听状态变化：

// 连接蓝牙设备
sdk.connectBluetooth();

// 监听蓝牙状态变化
sdk.on('bluetoothConnected', () => {
    console.log('蓝牙已连接');
});

sdk.on('bluetoothDisconnected', () => {
    console.log('蓝牙已断开');
});

蓝牙指令发送

注意：为安全考虑，手动发送蓝牙指令功能已被禁用。所有蓝牙指令只能通过以下方式发送：

• 视频时间点触发：视频播放到特定时间点时自动发送配置的指令
• 浮窗按钮控制：页面右下角的浮窗按钮（按钮2）随机发送测试指令
• 暂停自动触发：视频暂停时自动发送停止指令（通过sendPauseCommand()）

浮窗按钮使用说明：

1. 页面右下角点击⚙️图标打开浮窗菜单
2. 连接蓝牙设备后，按钮2将变为可用状态
3. 点击按钮2随机发送一个测试蓝牙指令
4. 点击按钮3停止设备并断开蓝牙连接

全局快捷对象（可选）

SDK会自动创建全局快捷对象，简化调用：

// 使用全局对象
Leviosa.init({ ... });
Leviosa.connectBluetooth();
Leviosa.disconnectBluetooth();
// 注意：sendBluetoothCommand() 方法已被禁用
// 蓝牙指令只能通过视频时间点触发或浮窗按钮发送

// 或使用别名
leviosa.connectBluetooth();