Repository navigation
Releases
iOS 2.0.0
TiSynth 2.0.0 introduces a reusable sound API:
var synth = require('ti.synthengine')
var W = synth.getContract().waveTypes
var bell = synth.createSound({
sound: { waveType: W.SINE, volume: 0.25, release: 120 },
playback: { notes: ['A4'], duration: 400 }
})
// After engine startup:
bell.play()
bell.play({ notes: ['C5'] })- Separate synthesis settings (
sound) from default notes and timing (playback). - Use
play()for finite sounds, chords, repetitions and patterns. UsenoteOn()for held notes. - Update definitions with atomic
set()changes and retrieve them withgetPreset(). - Update or stop playback through returned controls, without managing native identifiers.
- Configure shared effects through
setProcessing(), with delay and reverb times in milliseconds. - Preserve existing playback calls and native rendering behavior.
- Fix held-note identifier retention and invalidate playback controls after shutdown.
Runtime metadata now uses version; update checks that read apiVersion. Documentation, TypeScript declarations and the runnable example cover the new interface.
See the API reference, upgrade guide and validation results and limits.
Requires Titanium SDK 13.2.0.GA or later and iOS 15 or later. Includes device, simulator and Mac Catalyst builds. Download ti.synthengine-iphone-2.0.0.zip.
Android 2.0.0
TiSynth 2.0.0 introduces a reusable sound API:
var synth = require('ti.synthengine')
var W = synth.getContract().waveTypes
var bell = synth.createSound({
sound: { waveType: W.SINE, volume: 0.25, release: 120 },
playback: { notes: ['A4'], duration: 400 }
})
// After engine startup:
bell.play()
bell.play({ notes: ['C5'] })- Separate synthesis settings (
sound) from default notes and timing (playback). - Use
play()for finite sounds, chords, repetitions and patterns. UsenoteOn()for held notes. - Update definitions with atomic
set()changes and retrieve them withgetPreset(). - Update or stop playback through returned controls, without managing native identifiers.
- Configure shared effects through
setProcessing(), with delay and reverb times in milliseconds. - Preserve existing playback calls and native rendering behavior.
- Fix held-note identifier retention and invalidate playback controls after shutdown.
Runtime metadata now uses version; update checks that read apiVersion. Documentation, TypeScript declarations and the runnable example cover the new interface.
See the API reference, upgrade guide and validation results and limits.
Requires Titanium SDK 13.2.0.GA or later and Android compile API 35 or later. Download ti.synthengine-android-2.0.0.zip.
iOS 1.1.1
This patch adds the iOS privacy manifest and changes how the engine seeds noise. The JavaScript API stays at 1.1.0.
- Add
PrivacyInfo.xcprivacyinsideTiSynthEnginePrivacy.bundle. It declares System Boot Time access with reason35F9.1for elapsed-time statistics, with no tracking or data collection. - Remove boot-time API calls from noise seeding. The engine gets entropy from the OS at startup, then derives seeds in the audio callback without OS calls, memory allocations or locks.
Requires Titanium SDK 13.2.0.GA or later and iOS 15 or later. The ZIP includes device, simulator and Mac Catalyst builds.
Install ti.synthengine-iphone-1.1.1.zip from the assets below. Android stays at 1.1.0.
Built from 3eff75d. The fresh build passed, and the privacy manifest was verified inside the ZIP. Native Apple host regression tests, including noise seeding, passed locally during implementation. CI host tests passed; the macOS job could not get a hosted runner.
SHA256: b2d42b90c6d20989ccf407b7227a28c6ac7ef940313f76b9e8f760c8eb5fa54f
iOS 1.1.0
This release adds native repetition for finite tones and per-attack variation. The public JavaScript API is 1.1.0.
- Add
repeatTone(recipe), withintervalMsinside the recipe and a positive tone ID on acceptance. - Add
updateToneandstopTonefor future attacks while active attacks finish their original lifetimes. - Schedule up to 32 independent repetitions on the native audio sample clock, separately from the four sequence slots.
- Keep Boolean acceptance and independent successive calls for
playTone. - Add deterministic native attack variation for finite tones, sustained-note attacks and sequence attacks.
- Document
updateNote, itsupdateVoicecompatibility alias, andenableStats/disableStatsalongside thesetStatsEnabledalias.
A positive repetition ID accepts the recipe; each attack still uses the shared voice pool. Reserve room for overlapping attacks and release tails when an app must avoid voice stealing. Partial edits preserve the next attack deadline. Compatibility aliases have no scheduled removal date.
Requires Titanium SDK 13.2.0.GA or newer and iOS 15 or newer. Device, simulator and Mac Catalyst builds are included.
Install the attached ti.synthengine-iphone-1.1.0.zip. The other package is in Android 1.1.0.
Built from 7cd0354. Linux and macOS CI passed. See native tone repetition validation for checks and their scope.
Android 1.1.0
This release adds native repetition for finite tones and per-attack variation. The public JavaScript API is 1.1.0.
- Add
repeatTone(recipe), withintervalMsinside the recipe and a positive tone ID on acceptance. - Add
updateToneandstopTonefor future attacks while active attacks finish their original lifetimes. - Schedule up to 32 independent repetitions on the native audio sample clock, separately from the four sequence slots.
- Keep Boolean acceptance and independent successive calls for
playTone. - Add deterministic native attack variation for finite tones, sustained-note attacks and sequence attacks.
- Document
updateNote, itsupdateVoicecompatibility alias, andenableStats/disableStatsalongside thesetStatsEnabledalias.
A positive repetition ID accepts the recipe; each attack still uses the shared voice pool. Reserve room for overlapping attacks and release tails when an app must avoid voice stealing. Partial edits preserve the next attack deadline. Compatibility aliases have no scheduled removal date.
Requires Titanium SDK 13.2.0.GA or newer and Android compile API 35 or newer. The package includes arm64-v8a, armeabi-v7a, x86 and x86_64 libraries.
Install the attached ti.synthengine-android-1.1.0.zip. The other package is in iOS 1.1.0.
Built from 7cd0354. Linux and macOS CI passed. See native tone repetition validation for checks and their scope.
iOS 1.0.2
This release updates the final audio stage while keeping one stereo output per platform.
- Apply the documented
rawprofile at startup; it previously retained the conservative source gain. - Remove the mandatory 10 ms final-output lookahead with shared stereo sample-peak protection.
- Use the shared linear 10 ms master ramp, including volume changes published during a callback.
- Exercise production rendering and startup profile selection in host regressions.
- Add Apple preset calibration across six voice counts, with stress results reported separately.
The final stage retains zero samples. Overload changes the waveform, and gain recovers with a 100 ms exponential time constant. Sample ceilings remain 0.85, or 0.70 for speakerSafe. Public methods, fixed event gains and chord compensation remain unchanged.
Apps that request raw now receive its documented higher source gain. Review their gain staging when updating.
Production-renderer checks cover 16, 44.1, 48, 96 and 192 kHz. The matched host comparison preserved all 40 cases without overload within an absolute float tolerance of 1e-7 after aligning the old delay. Studio and Frontier comparisons ran on an Android device and an iPad; route-wide latency, Bluetooth behavior and extended maximum-load acceptance remain outside those results.
The public JavaScript API remains at version 1.0.0. Requires Titanium SDK 13.2.0.GA or newer and iOS 15 or newer. Device, simulator and Mac Catalyst builds are included.
Install the attached ti.synthengine-iphone-1.0.2.zip. The other package is in Android 1.0.2.
Built from 4a45f21. Linux and macOS CI passed. See validation and compatibility for scope and remaining limits.
iOS 1.0.1
This release applies the idle-polling improvement to the Apple implementation.
- Run the 10 ms event timer only while accepted sequences or held-voice metadata need retirement.
- Stop the timer after the last pending item is retired and restart it when new work is accepted.
- Ignore callbacks from a previous timer after shutdown or restart, while preserving held-voice metadata cleanup.
The regression test exercises the production event methods with real dispatch timers and the shared transport. It covers idle startup, rejected publications, event delivery, metadata cleanup, and shutdown or restart from an event listener.
Audio rendering and the public JavaScript API remain unchanged. Requires Titanium SDK 13.2.0.GA or newer and iOS 15 or newer. Device, simulator, and Mac Catalyst builds are included.
Install the attached ti.synthengine-iphone-1.0.1.zip. The Android package is in Android 1.0.1.
Built from e52a92b. Linux and macOS CI passed.
Android 1.0.2
This release updates the final audio stage while keeping one stereo output per platform.
- Remove the mandatory 10 ms final-output lookahead with shared stereo sample-peak protection.
- Use an exact linear 10 ms master-volume ramp, matching iOS.
- Report stream latency without adding the removed lookahead.
- Run output regressions against the production callback and startup profile selector.
- Expand preset calibration across six voice counts and report usual workloads separately from stress cases.
The final stage retains zero samples. Overload changes the waveform, and gain recovers with a 100 ms exponential time constant. Sample ceilings remain 0.85, or 0.70 for speakerSafe. Public methods, fixed event gains and chord compensation remain unchanged.
Android can still report an underrun during startup. The symptom also reproduced with an independent Oboe 1.11.0 callback that writes silence. Its cause remains under investigation; the counter is retained.
Production-renderer checks cover 16, 44.1, 48, 96 and 192 kHz. The matched host comparison preserved all 40 cases without overload within an absolute float tolerance of 1e-7 after aligning the old delay. Studio and Frontier comparisons ran on an Android device and an iPad; route-wide latency, Bluetooth behavior and extended maximum-load acceptance remain outside those results.
The public JavaScript API remains at version 1.0.0. Requires Titanium SDK 13.2.0.GA or newer and Android compile API 35 or newer.
Install the attached ti.synthengine-android-1.0.2.zip. The other package is in iOS 1.0.2.
Built from 4a45f21. Linux and macOS CI passed. See validation and compatibility for scope and remaining limits.
Android 1.0.1
Thanks to @m1ga for the Android fixes in #1.
- Update Oboe from 1.10.0 to 1.11.0.
- Attempt to reopen the audio stream after any error delivered to
onErrorAfterClose. - Poll for
sequenceendevents only while accepted sequences remain, and prevent duplicate poll chains when a listener restarts the engine. - Release the audio stream when Titanium destroys the root activity.
- Remove the unused
Threadinheritance fromSynthThread.
Tested on an OPPO CPH2639 running Android 16, including headphone connection and removal, sequence events, and activity teardown with the process left in cache. Timeout and invalid-state errors were not injected.
The public JavaScript API remains at version 1.0.0. Requires Titanium SDK 13.2.0.GA or newer and Android compile API 35 or newer.
Install the attached ti.synthengine-android-1.0.1.zip. The Apple package is in iOS 1.0.1.
Built from e52a92b. Linux and macOS CI passed.
iOS 1.0.0
Initial official release of TiSynthEngine for Titanium.
- Generate tones, sustained voices, chords and native sample-clock sequences with nineteen public methods.
- Add ADSR, resonant filters, FM, waveform shaping, voice priorities and headphone binaural positioning.
- Share chorus, ping-pong delay, reverb, selective sends and two optional voice LFOs.
- Include opt-in statistics, the interactive example and complete API/integration documentation.
- Build device, simulator and Mac Catalyst variants; optimize full-score publication and control-memory handling while retaining the verified original renderer.
Requires Titanium SDK 13.2.0.GA or newer and iOS 15 or newer. Install the attached ti.synthengine-iphone-1.0.0.zip; the matching Android package is in Android 1.0.0.
The performance review records byte-exact compatibility, physical measurements and remaining certification limits. Experimental render optimizations that regressed stereo timing were excluded. Physical 192 kHz acceptance and strict population-matched iPad game comparison remain open; output underruns are unavailable on this backend.
Built from e7cbbe8. Linux and macOS CI passed.