Known Issues

In IIIFPlayer component

• For streaming resources, the HLS is handled by VideoJS, not in the ReactJS component. Right now only .m3u8 files created from .mp4 files work with VideoJS, but not those created from .mp3 files (related issue)

• Switching between the canvases while the media is playing logs an error into the browser console. This is because, the VideoJS instance in the application is trying to access the currentTime property while the new instance is getting created. We have tried fixing this by always checking the existence of the VideoJS instance in the application before accessing the properties/functions within the the VideoJS instance. Still, this error is shown sometimes. But this doesn't affect the functionality of the IIIFPlayer component. The error is as follows;

VIDEOJS: ERROR: TypeError: Cannot read property 'currentTime' of null at Html5.<computed> [as currentTime]

The above error has been fixed in @samvera/[email protected] with the work completed in [BUG] Auto-advancing to next Canvas

• In iOS versions > 17, the media doesn't fully load into iOS' native player when entered into full-screen mode without playing the media. This is a bug introduced in iOS 17 native player. A workaround this would be to either play the media in web-view without entering full-screen mode or exit full-screen mode and enter full-screen mode again to load relevant metadata into iOS' native player (related issue).

This issue is fixed in Ramp player in @samvera/[email protected] with the work completed in Force player to load in Safari and iOS browsers.

In Transcript component

• SRT files are not supported as captions in Ramp 3.0.0 and will not render in the media player or in the transcript component (the media player used in Ramp, Video.js, does not have native support for SRT). Display support for this format will be added in a future release.

SRT support for Transcript component is added in @samvera/[email protected]

• WebVTT transcript files: WebVTT files can have multiple time formats in the timestamp. Right now the parser can only handle the hh:mm:ss.tt format. Therefore all the other time formats, the parser fails to read the transcripts, and shows the warning Invalid transcript(s) in the Transcript component.

The above issue has been fixed in @samvera/[email protected] with the work completed in Update WebVTT parser

• Go ogle Doc Viewer randomly failing: Word documents and Plain text files are accepted as transcript files in the Transcript component. To render these file types within the component, the component uses an iframe embedding a Google Doc Viewer. Occasionally this fails; when this happens, a full reload of the page is required to restore the service.

The above error has been resolved in @samvera/[email protected] also carried over to the renamed NPM package @samvera/[email protected] by replacing the Google Doc Viewer in the transcript component with mammoth, an external HTML parser to convert the MS Word documents to HTML to view on page.