Back to Details

azure-immersive-reader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Azure AI Immersive Reader Skill

Azure AI Immersive Reader技能

This skill provides expert guidance for Azure AI Immersive Reader. Covers best practices, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
本技能为Azure AI Immersive Reader提供专业指导，涵盖最佳实践、限制与配额、安全、配置以及集成与编码模式。它结合了本地快速参考内容与远程文档获取功能。

How to Use This Skill

如何使用本技能

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., 
L35-L120
), use 
read_file
with the specified lines. For categories with file links (e.g., 
[security.md](security.md)
), use 
read_file
on the linked reference file
IMPORTANT for Agent: If 
metadata.generated_at
is more than 3 months old, suggest the user pull the latest version from the repository. If 
mcp_microsoftdocs
tools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
  • Preferred: Use 
    mcp_microsoftdocs:microsoft_docs_fetch
    with query string 
    from=learn-agent-skill
    . Returns Markdown.
  • Fallback: Use 
    fetch_webpage
    with query string 
    from=learn-agent-skill&accept=text/markdown
    . Returns Markdown.
Agent注意事项：使用下方的分类索引查找相关章节。对于带有行范围的分类（例如 
L35-L120
），使用
read_file
并指定对应行。对于带有文件链接的分类（例如 
[security.md](security.md)
），对链接的参考文件执行
read_file
操作
Agent注意事项：如果
metadata.generated_at
已超过3个月，建议用户从仓库拉取最新版本。如果
mcp_microsoftdocs
工具不可用，建议用户进行安装：安装指南
本技能需要网络访问权限以获取文档内容：
  • 首选方式：使用
    mcp_microsoftdocs:microsoft_docs_fetch
    ，查询字符串为
    from=learn-agent-skill
    ，返回Markdown格式内容。
  • 备用方式：使用
    fetch_webpage
    ，查询字符串为
    from=learn-agent-skill&accept=text/markdown
    ，返回Markdown格式内容。

Category Index

分类索引

CategoryLinesDescription
Best PracticesL33-L37Guidance on improving Immersive Reader performance by caching authentication tokens, including token reuse patterns and reducing auth overhead.
Limits & QuotasL38-L42Supported languages and feature availability for Immersive Reader (e.g., which languages work with read-aloud, translation, and other capabilities).
SecurityL43-L49Configuring Immersive Reader security: creating the resource with Entra auth, managing Entra role assignments, and setting cookie policy and user consent.
ConfigurationL50-L56Configuring Immersive Reader behavior: read-aloud voice/speed, translation languages and behavior, and storing/managing per-user reading and language preferences.
Integrations & Coding PatternsL57-L66Implementing Immersive Reader in web/iOS apps: launch flows, JS SDK usage, HTML/MathML prep, custom buttons, multi-resource setups, and Vision Read integration.
分类行范围描述
最佳实践L33-L37通过缓存身份验证令牌提升Immersive Reader性能的指导，包括令牌重用模式和减少身份验证开销。
限制与配额L38-L42Immersive Reader支持的语言和功能可用性（例如哪些语言支持朗读、翻译及其他功能）。
安全L43-L49配置Immersive Reader安全：创建带Entra身份验证的资源、管理Entra角色分配，以及设置Cookie策略和用户同意。
配置L50-L56配置Immersive Reader行为：朗读语音/速度、翻译语言与行为，以及存储/管理每位用户的阅读和语言偏好。
集成与编码模式L57-L66在Web/iOS应用中实现Immersive Reader：启动流程、JS SDK使用、HTML/MathML内容准备、自定义按钮、多资源设置以及Vision Read集成。

Best Practices

最佳实践

TopicURL
Cache Immersive Reader auth tokens for performancehttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token
主题链接
缓存Immersive Reader身份验证令牌以提升性能https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token

Limits & Quotas

限制与配额

TopicURL
Check supported languages for Immersive Reader featureshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support
主题链接
查看Immersive Reader功能支持的语言https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support

Security

安全

TopicURL
Create Immersive Reader resource and configure Entra authhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader
Configure Immersive Reader cookie policy and consenthttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy
Update Immersive Reader Entra role assignments for securityhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment
主题链接
创建Immersive Reader资源并配置Entra身份验证https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader
配置Immersive Reader Cookie策略与用户同意https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy
更新Immersive Reader Entra角色分配以保障安全https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment

Configuration

配置

TopicURL
Configure Immersive Reader Read Aloud optionshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud
Configure translation settings in Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation
Store and manage Immersive Reader user preferenceshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences
主题链接
配置Immersive Reader朗读选项https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud
配置Immersive Reader翻译设置https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation
存储与管理Immersive Reader用户偏好https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences

Integrations & Coding Patterns

集成与编码模式

TopicURL
Customize the Immersive Reader launch buttonhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
Launch Azure Immersive Reader from application codehttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
Use multiple Immersive Reader resources in one apphttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
Prepare HTML content for Immersive Reader integrationhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
Render MathML expressions in Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
Use the Immersive Reader JavaScript SDK APIhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
Build iOS app integrating Vision Read and Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader
主题链接
自定义Immersive Reader启动按钮https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
从应用代码中启动Azure Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
在单个应用中使用多个Immersive Reader资源https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
准备HTML内容以集成Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
在Immersive Reader中渲染MathML表达式https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
使用Immersive Reader JavaScript SDK APIhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
构建集成Vision Read与Immersive Reader的iOS应用https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader