The Immersive Reader JavaScript SDK is a JavaScript library that allows you to easily and quickly integrate the [Immersive Reader](https://azure.microsoft.com/services/immersive-reader) into your web application.
npm install @microsoft/immersive-reader-sdkhtml
`
`bash
npm install @microsoft/immersive-reader-sdk
`
`bash
yarn add @microsoft/immersive-reader-sdk
`
Add an HTML element to your webpage with the immersive-reader-button class attribute.
`html
`
Next, invoke the Immersive Reader when the button is clicked:
`javascript
function launchImmersiveReader() {
const content = {
title: 'Immersive Reader',
chunks: [ {
content: 'Hello, world!'
} ]
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, content);
}
`
Take a look at the samples for examples of a full end-to-end integration.
The Immersive Reader may use persistent cookies to maintain user preferences and track feature usage. When embedding the Immersive Reader into applications, please consider the requirements of EU Cookie Compliance Policy. Setting the cookiePolicy option to CookiePolicy.Enable will enable the Immersive Reader to use cookies. It is the responsibility of the host application to obtain any necessary user consent in accordance with EU Cookie Compliance Policy.
Building
In order to build the SDK, ensure that you have Git, Node.js, and Yarn installed.
Clone a copy of the repo:
`bash
git clone https://github.com/microsoft/immersive-reader-sdk
`
Change to the immersive-reader-sdk directory:
`bash
cd immersive-reader-sdk
`
Install dependencies:
`bash
yarn
`
Build and test:
`bash
yarn run build
yarn run test
``