@4players/odin-nodejs 0.10.3 → 0.11.1

package/tests/sending-audio/test-kiss-api.js

@@ -0,0 +1,149 @@
+/**
+ * ODIN Node.js SDK - Audio Sending Example (High-Level API)
+ * 
+ * This example demonstrates the HIGH-LEVEL API for sending audio to an ODIN room.
+ * The high-level API handles all the complexity automatically:
+ * - Media ID allocation from the Joined event
+ * - StartMedia RPC to notify the server  
+ * - Proper 20ms chunk timing
+ * - Audio decoding for MP3/WAV files
+ * 
+ * With the high-level API, sending audio is just:
+ *   await media.sendMP3('./file.mp3');
+ * 
+ * For full control, see index.js which uses the LOW-LEVEL API.
+ * 
+ * Prerequisites:
+ * - Replace __YOUR_ACCESS_KEY__ with your ODIN access key
+ * - Get a free access key at https://www.4players.io/odin
+ */
+
+import odin from '../../index.cjs';
+const { OdinClient, OdinCipher } = odin;
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get the directory of the current script
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ============================================
+// Configuration - Replace with your values
+// ============================================
+
+/** 
+ * Your ODIN access key. Get one for free at https://www.4players.io/odin
+ * @type {string}
+ */
+const accessKey = "__YOUR_ACCESS_KEY__";
+
+/**
+ * The room ID to join. All users joining the same room can hear your audio.
+ * @type {string}
+ */
+const roomId = "__YOUR_ROOM_ID__";
+
+/**
+ * Your unique user identifier.
+ * @type {string}
+ */
+const userId = "AudioBot-" + Math.floor(Math.random() * 10000);
+
+/**
+ * Optional: Password for End-to-End Encryption.
+ * Set to null to disable, or set a string that matches other peers.
+ * @type {string|null}
+ */
+const cipherPassword = null;
+
+// ============================================
+// Main Function
+// ============================================
+
+async function main() {
+    console.log("=== ODIN NodeJS SDK - High-Level API Audio Test ===\n");
+
+    // Step 1: Create ODIN client
+    console.log("1. Creating ODIN client...");
+    const client = new OdinClient();
+
+    // Step 2: Generate token from access key
+    console.log("2. Generating token from access key...");
+    const token = client.generateToken(accessKey, roomId, userId);
+    console.log("   Token generated.\n");
+
+    // Step 3: Create room
+    console.log("3. Creating room...");
+    const room = client.createRoom(token);
+
+    // Step 4: Set up E2EE cipher (optional)
+    if (cipherPassword) {
+        console.log("4. Setting up E2EE cipher...");
+        const cipher = new OdinCipher();
+        cipher.setPassword(new TextEncoder().encode(cipherPassword));
+        room.setCipher(cipher);
+        console.log("   E2EE enabled.\n");
+    } else {
+        console.log("4. E2EE disabled.\n");
+    }
+
+    // Wait for join to complete
+    const joinPromise = new Promise(resolve => room.onJoined(resolve));
+
+    // Prepare user data
+    const userData = new TextEncoder().encode(JSON.stringify({
+        name: "High-Level API Bot",
+        platform: "ODIN Node.js SDK"
+    }));
+
+    // Step 5: Join the room
+    console.log("5. Joining room...");
+    room.join("https://gateway.odin.4players.io", userData);
+
+    // Wait for join confirmation
+    console.log("   Waiting for room join...");
+    const joinEvent = await joinPromise;
+    console.log(`   Joined! Own Peer ID: ${joinEvent.ownPeerId}`);
+    console.log(`   Available media IDs: ${JSON.stringify(room.availableMediaIds)}\n`);
+
+    // Step 6: Create audio stream
+    console.log("6. Creating audio stream (44.1kHz, stereo)...");
+    const media = room.createAudioStream(44100, 2);
+    console.log("   Audio stream created.\n");
+
+    // Step 7: Send MP3 with one line! (high-level API magic)
+    // The sendMP3 method automatically:
+    // - Claims a media ID from the available pool
+    // - Sends the StartMedia RPC
+    // - Decodes the MP3 file
+    // - Streams audio in 20ms chunks with correct timing
+    console.log("7. Sending MP3 file (auto handles setup & timing)...");
+    const audioFile = path.join(__dirname, 'canBounce.mp3');
+    console.log(`   File: ${audioFile}`);
+
+    await media.sendMP3(audioFile);
+
+    console.log("   Audio streaming complete!\n");
+
+    // Wait a bit for final audio to transmit
+    console.log("8. Waiting for transmission to complete...");
+    await new Promise(r => setTimeout(r, 2000));
+
+    // Step 9: Clean up
+    console.log("9. Cleaning up...");
+    media.close();
+    room.close();
+    console.log("   Resources released.\n");
+
+    console.log("=== Test Complete ===");
+    process.exit(0);
+}
+
+// ============================================
+// Entry Point
+// ============================================
+
+main().catch(err => {
+    console.error("Error:", err);
+    process.exit(1);
+});

package/tests/sending-audio/test-loop-audio.js

@@ -0,0 +1,142 @@
+/**
+ * ODIN Node.js SDK - Multiple Audio Sending Test
+ * 
+ * This test verifies that multiple audio files can be sent in sequence
+ * within a single room connection. It creates a media stream, sends an MP3,
+ * closes the media, waits 5 seconds, and repeats.
+ * 
+ * This is a regression test for issues where sending multiple MP3s in
+ * one connection instance would fail.
+ */
+
+import odin from '../../index.cjs';
+const { OdinClient, OdinCipher } = odin;
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get the directory of the current script
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ============================================
+// Configuration - Replace with your values
+// ============================================
+
+const accessKey = "__YOUR_ACCESS_KEY__";
+const roomId = "__YOUR_ROOM_ID__";
+const userId = "LoopBot-" + Math.floor(Math.random() * 10000);
+const cipherPassword = "__YOUR_CIPHER_PASSWORD_OR_NULL__";
+
+// Number of times to send the audio file
+const LOOP_COUNT = 3;
+
+// Delay between sends (in milliseconds)
+const DELAY_BETWEEN_SENDS = 5000;
+
+// ============================================
+// Main Function
+// ============================================
+
+async function main() {
+    console.log("=== ODIN NodeJS SDK - Multiple Audio Sending Test ===\n");
+    console.log(`Will send audio ${LOOP_COUNT} times with ${DELAY_BETWEEN_SENDS}ms delay between sends.\n`);
+
+    // Step 1: Create ODIN client
+    console.log("1. Creating ODIN client...");
+    const client = new OdinClient();
+
+    // Step 2: Generate token from access key
+    console.log("2. Generating token from access key...");
+    const token = client.generateToken(accessKey, roomId, userId);
+    console.log("   Token generated.\n");
+
+    // Step 3: Create room
+    console.log("3. Creating room...");
+    const room = client.createRoom(token);
+
+    // Step 4: Set up E2EE cipher (optional)
+    if (cipherPassword) {
+        console.log("4. Setting up E2EE cipher...");
+        const cipher = new OdinCipher();
+        cipher.setPassword(new TextEncoder().encode(cipherPassword));
+        room.setCipher(cipher);
+        console.log("   E2EE enabled.\n");
+    } else {
+        console.log("4. E2EE disabled.\n");
+    }
+
+    // Wait for join to complete
+    const joinPromise = new Promise(resolve => room.onJoined(resolve));
+
+    // Prepare user data
+    const userData = new TextEncoder().encode(JSON.stringify({
+        name: "Loop Audio Bot",
+        platform: "ODIN Node.js SDK"
+    }));
+
+    // Step 5: Join the room
+    console.log("5. Joining room...");
+    room.join("https://gateway.odin.4players.io", userData);
+
+    // Wait for join confirmation
+    console.log("   Waiting for room join...");
+    const joinEvent = await joinPromise;
+    console.log(`   Joined! Own Peer ID: ${joinEvent.ownPeerId}`);
+    console.log(`   Available media IDs: ${JSON.stringify(room.availableMediaIds)}\n`);
+
+    const audioFile = path.join(__dirname, 'canBounce.mp3');
+
+    // Loop: Send audio multiple times
+    for (let i = 1; i <= LOOP_COUNT; i++) {
+        console.log(`\n========== ITERATION ${i}/${LOOP_COUNT} ==========\n`);
+
+        // Step 6: Create audio stream
+        console.log(`${i}.1 Creating audio stream (44.1kHz, stereo)...`);
+        const media = room.createAudioStream(44100, 2);
+        console.log("     Audio stream created.");
+        console.log(`     Available media IDs after create: ${JSON.stringify(room.availableMediaIds)}`);
+
+        // Step 7: Send MP3 with high-level API
+        console.log(`${i}.2 Sending MP3 file...`);
+        console.log(`     File: ${audioFile}`);
+
+        try {
+            await media.sendMP3(audioFile);
+            console.log("     Audio streaming complete!");
+        } catch (error) {
+            console.error(`     ERROR during sendMP3: ${error.message}`);
+            console.error(error.stack);
+        }
+
+        // Step 8: Close media
+        console.log(`${i}.3 Closing media stream...`);
+        media.close();
+        console.log("     Media stream closed.");
+        console.log(`     Available media IDs after close: ${JSON.stringify(room.availableMediaIds)}`);
+
+        // Wait before next iteration (except on last iteration)
+        if (i < LOOP_COUNT) {
+            console.log(`\n${i}.4 Waiting ${DELAY_BETWEEN_SENDS}ms before next send...`);
+            await new Promise(r => setTimeout(r, DELAY_BETWEEN_SENDS));
+            console.log("     Wait complete.");
+        }
+    }
+
+    // Final cleanup
+    console.log("\n========== CLEANUP ==========\n");
+    console.log("Closing room...");
+    room.close();
+    console.log("Room closed.\n");
+
+    console.log("=== Test Complete ===");
+    process.exit(0);
+}
+
+// ============================================
+// Entry Point
+// ============================================
+
+main().catch(err => {
+    console.error("Error:", err);
+    process.exit(1);
+});

package/CMakeLists.txt

@@ -1,25 +0,0 @@
-cmake_minimum_required(VERSION 3.24)
-project(odin_nodejs)
-
-set(CMAKE_CXX_STANDARD 14)
-
-add_definitions(-DNAPI_VERSION=4)
-
-include_directories(cppsrc/samples)
-include_directories(libs)
-include_directories(libs/include)
-include_directories(node_modules/node-addon-api)
-
-add_executable(odin_nodejs
-        cppsrc/odinbindings.cpp
-        cppsrc/odinbindings.h
-        cppsrc/odinroom.cpp
-        cppsrc/odinroom.h
-        cppsrc/binding.cpp
-        libs/include/odin.h
-        node_modules/node-addon-api/napi-inl.deprecated.h
-        node_modules/node-addon-api/napi-inl.h
-        node_modules/node-addon-api/napi.h
-        node_modules/node-addon-api/nothing.c
-        node_modules/node-gyp/gyp/data/win/large-pdb-shim.cc
-        node_modules/node-gyp/src/win_delay_load_hook.cc cppsrc/odinbindings.h cppsrc/odinbindings.cpp cppsrc/odinroom.h cppsrc/odinroom.cpp cppsrc/utilities.cpp cppsrc/utilities.h cppsrc/odinclient.h cppsrc/odinclient.cpp cppsrc/odinmedia.h cppsrc/odinmedia.cpp)