@beyondwords/player

BeyondWords Player

DO NOT USE: This is an alpha version of the player and is not officially released yet. We are testing the new player internally and will remove this notice once it is ready.

BeyondWords is an AI voice and audio CMS that enables publishers to transform their content into natural-sounding and captivating audio experiences for their audiences. This repository includes the BeyondWords player, which seamlessly integrates with the BeyondWords audio CMS and can be easily embedded into your website or app. You can sign up for a free account here.

The easiest way to embed the BeyondWords player into your website is by copying the player scripts inside the BeyondWords CMS. However, for those who wish to customize the player further, this documentation provides helpful guides and a detailed explanation for each of the player's settings. You can see a demo of the player here.

Documentation

The doc/ directory contains these useful resources:

1. Getting started: A guide for how to embed the player on your website using a <script> tag.
2. NPM package: A guide for how to add the player to your website using the NPM package.
3. Player SDK: An explanation of how to control the player programmatically by using the SDK.
4. Player settings: A list of all supported player settings that can be set in the initializer or via the SDK.
5. Listening to events: How to register event listeners that are called when player actions are performed.
6. Player events: A list of all events emitted by the player that can be listened to.
7. Segments playback: How to add support for the 'Playback from Segments' feature to your website.
8. Custom analytics: How to send player analytics events to a custom URL of your choosing.
9. Building your own UI: How to build your own user-interface on top of the BeyondWords player.
10. How it works: A technical overview of how the player works, including API calls that are made.
11. Dev setup: How to run this project locally, e.g. if you are a developer at BeyondWords.
12. Dev workflow: Useful advice for working on the player, including what all the ./bin scripts do.
13. Code layout: An explanation of the layout of code in the player. Each major subdirectory is listed.
14. Deployment: How to release a new version of the player to the public and some things to consider.

Contribution

We welcome contributions from our customers, and members of the public. Please open a GitHub issue if you are having trouble using the player or something isn't working as expected.

We'd prefer you didn't fork this repository and instead contact us if you have a requirement that is not met by the current player. Note that it is possible to build a custom user-interface on top of the existing player.

License

All code in this repository is Copyright, BeyondWords, 2023.

You may embed the player in your project and use the NPM package provided it is not modified.