SnapBeat SDK

Package: com.amanotes.snapbeat
Version: 1.3.0

Unity WebGL SDK for HTML/JavaScript control of rhythm games with external song loading and game state management.

Features

• 🎮 WebGL JavaScript API for external control
• 🎯 Song data loading from JSON
• 🎨 Game state management (Play, Pause, Stop, Seek)
• 🚀 Audio timing synchronization
• 🔧 Event callbacks for game events

Documentation

Complete documentation: Docs/SnapBeat-Implementation-Guide.md

Installation

Add the package to your Unity project via Packages/manifest.json:

{
  "dependencies": {
    "com.amanotes.snapbeat": "1.3.0"
  },
  "scopedRegistries": [
    {
      "name": "npmjs",
      "url": "https://registry.npmjs.org/",
      "scopes": [
        "com.amanotes.snapbeat"
      ]
    }
  ]
}

Quick Start

public class MyGameController : MonoBehaviour
{
    private SnapBeatSDK snapBeatSDK;
    
    void Start()
    {
        snapBeatSDK = GetComponent<SnapBeatSDK>();
    }
}

JavaScript:

loadSong("https://example.com/song.json");
snapBeat.startGame();
snapBeat.pauseGame();
snapBeat.seekGame(5000);

API Reference

Key Classes

SnapBeatSDK

• Purpose: Main SDK component for WebGL integration
• Key methods: LoadSongData(), StartGame(), PauseGame(), SeekGame()

ISnapBeatGameController

• Purpose: Game controller interface
• Key methods: Interface for game state management

ISnapBeatEventEmitter

• Purpose: Event emitter interface
• Key methods: Send game events to JavaScript

See: Complete Implementation Guide

Dependencies

• Unity 2021.3+
• Unity WebGL platform
• com.amanotes.rhythmjson: 2.1.0
• com.unity.nuget.newtonsoft-json: 3.0.0

Version History

See CHANGELOG.md