沈浸式閱讀程式的運作方式

已完成

沈浸式閱讀程式可以藉由使用 JavaScript SDK 整合至應用程式。 若要使用沉浸式閱讀程式,您必須先建立沉浸式閱讀程式資源,並設定 Microsoft Entra 驗證。 您能在「單元 6 - 摘要」中找到如何使用如 Python、C#、Java 和 Node.js 等語言設定沈浸式閱讀程式的快速入門和進階範例。

內嵌沈浸式閱讀程式

您可以使用用戶端程式庫將沈浸式閱讀程式內嵌至應用程式,其會在在 iframe 中現有的 Web 應用程式上顯示沈浸式閱讀程式。 下列範例會將用戶端程式庫新增至 HTML:

<script src="https://contentstorage.onenote.office.net/onenoteltir/immersivereadersdk/immersive-reader-sdk.1.0.0.js"></script>

用戶端程式庫會提供一個啟動沈浸式閱讀程式的按鈕,觸發方式是網頁上的內容。 您可以將自訂樣式新增至按鈕、選擇沈浸式閱讀程式會進行互動的內容,並在 HTML 中以 id 標記指定語言。

強化可讀性和集中力

launchAsync 命令會使用您選取的內容開始沈浸式閱讀程式,且具有可讓您選取多個功能的 options 參數:

  • 間距和字型大小會透過處理「視覺擁擠效應」來改善閱讀速度。
  • 將字詞細分成音節來改善可讀性或將新的字詞唸出來。
  • 可醒目提示部分的詞性和文法,以協助學習者了解動詞、名詞、代名詞等。
  • 可針對不同的詞性選取不同色彩,以提高理解及閱讀的便利性。
  • 行聚焦一次只會視您的需求顯示一行、三行或五行。
  • 焦點模式只會顯示文字,撇除其他會轉移注意力的事物。
  • 圖片字典能透過多感官整合處理 (也就是同時查看圖片和聆聽字詞的能力) 協助閱讀和理解。
const options = {
    readAloudOptions: {
        autoplay: true,
        voice: 'female',
        speed: 1.5
    },
    translationOptions: {
        language: 'fr-FR',
        autoEnableDocumentTranslation: true
    },
    displayOptions: {
        textSize?: 20,
        increaseSpacing?: true
    }
};

ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, data, YOUR_OPTIONS);

數學方程式支援

當 MIME 型別設定為 application/mathml+xml 時,可以以 HTML 形式提供數學功能給沈浸式閱讀程式。 例如,下列 JavaScript 會尋找使用識別碼 ir-content 的 HTML 元素,並將 mimeType 設定為 'application/mathml+xml' 以將其顯示為數學:

const data = {
    title: 'My Math',
    chunks: [{
        content: document.getElementById('ir-content').innerHTML.trim(),
        mimeType: 'application/mathml+xml'
    }]
};

ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, data, YOUR_OPTIONS);

Math output.

在行動裝置上使用

Microsoft Lens (先前為 Microsoft Office Lens) 是一個 Android 和 iOS 應用程式,可對白板與文件圖片進行修剪、增強,使其更好閱讀。 沈浸式閱讀程式可透過 Microsoft Lens 使用,讓使用者可以將大聲朗讀、文字間距和色彩變更等功能套用至文件中。 不論這些函式位於何處,都能為所有讀者提供更高的易用性與公平性。