- 29ce783: bugfix - track instance always returning null at first render
- 2c98eea: allow accessing audioref on track stream interface and remove a built-in caption property ('description') which should be accessed from the custom 'metadata' property. Keep it less heavy in boilerplate.
- 8383035: bugfix/define subtitles on audio registration
-
37009bd: New feature -
updateFrequencyMs
option allows you to subscribe totimeupdate
events at a fixed custom frequency, eliminating device or browser-specific frequency differences that can result in unexpected user experience. New feature -onResolve
callback that runs ONLY when the audio has played successfully without error.New property -
useTrackStream
hook provides a new valuetrackIsPlaying
, which is a shortcut fortrackInstance.getState().isPlaying
. New property -error
state andended
states are separated and distinguished inAudioItemState
.- Minor performance improvements and bug fixes.
- 22fe772: Fix RegistrationArgTuple export (2)
- 578d7d4: Fix type export: RegistrationArgTuple
- c7527b7: Add feature: control individual tracks' playback rate value
- 1d2a29f: Better support parameter types for
registerAudio
andregisterAudios
method. Breaking change: the parameter for registerAudios has changed from one array of arguments to the enumerated classic list of arguments for flexibility and readibility.
- 0c63ac7: New track method:
isPlaying()
andpauseTrack()
which is a shortcut ofgetState().isPlaying
andtogglePlay(false)
. Also clarified the ts docs fortogglePlay()
method.
- f6dd883: Default export changed into a named export (RATM). Also this version introduces the expandable real-time metadata updates (previously limited to 'narrator' metadata.)
- Updated dependencies [f6dd883]
- 0517bd5: Added feature: register multiple audios at once
- 0a3e78d: Fixed omitted metadata bug related to registering play requests. Also added audio callbacks to play requests.
- e9ac8cc: Allow updating locale while rendering captions.
- b79d4f7: Stability update: Automatically reconstruct tracks with inherited locale (and other default audio options) on creation
- 6a87581: Type updates and documentation typo fixes.
- 97ef2ac: Important bugfix - Initial track properties were reassigned to undefined if options were not explicitly given.
- 5dfd325: 1. accept string as
useTrackStream
hook'skey
option 2. audio options inheritance related bugfix
-
5ff4bf1: 1. Jitsi-related type name changes to make it easier to understand.
-
Type name change (
AudioManagerState
=>AudiotrackManagerState
) -
Dynamic optimization of the hook
useTrackStream
with various options
-
- d6c7dfb: bugfix: false negative if statement in
Track.applyMasterVolume
method.
- d4e7035: changing
autoPlay
settings of an idle track will automatically triggerplay
.
-
1bb9ee2: First official release with documented class methods. It establishes a clear inheritance of settings between the global options and the individual tracks and audio settings and provides a track-targeted hook for better performance. Warning: It has a lot of backward-incompatible changes with the previous versions.
How to migrate: -
AudiotrackManager
is now default-exported - Accessing subtitle stream is no longer allowed from theuseAudiotracks
hook to optimize performance on the higher-order parent components. Now listen to the stream (captions and the inner audio states) directly from a child component usinguseTrackStream
for a specific track. -number_of_tracks
property is renamed totrackLength
. -globalVolume
property is renamed tomasterVolume
. -masterVolume
no longer overrides eachTrack
's volume property; it multiplies it instead.New hook:
useTrackStream
will provide aTrack
's stream state and the instance of itself to access the inner methods such asgetCurrentAudio
orgetNextAudio
. The stream state includes the real-time caption and the inner audio's state.
- e8b6e91: 1. Some of the
updateState
method parameters are limited for runtime safety reasons. 2.bugfix: tracksmuted
property wasn't visually updated whenglobalMuted
is updated.`
- fbaa424: bugfix- properly process allowDuplicates option
-
fb97dc3: 1. New methods: - updateAllTracks - getCurrentCaption
-
Method name change to make it easier to understand: toggleMuteAllSources -> toggleGlobalMute
-
globalMuted
now has a priority overtrack.muted
-
Minor bug fix (registerAudio) -> when trackIdx was not explicitly given, the default track idx (0) was not properly registered.
-
- 0a4939d: Improved play latency
- 3635c51: add demo website for npm repository
-
ef28a56: 1. new features - togglePlayTrack - resumeTrack
-
new track props
- currentAudio: class - AudioItem
- isPlaying: boolean
- loop: boolean
- autoPlay: boolean - will override queue items.autoPlay when changed.
-
deprecated track props (still supported but will be removed)
- currentlyPlaying: string - use currentAudio instead
-
new audio props
- autoPlay: boolean - will override track.autoPlay
- originalFilename
-
- 5d67506: added and updated example
- 46ef34a: 1. Now exports types. 2. Updated ReadMe Example code blocks. 3. bugfix: options arguments are now truly optional.
- efcf17a: A hail-mary pass to publish the library unscoped. Also fixed the branch name of the changeset.
- 73a3850: import refactoring