嵌入式流体播放器

企业现在可以在 Adobe Learning Manager 之外为学习者提供自定义体验。您可以使用公共 API，获取与学习对象、学习者注册和学习进度相关的所有信息，并将这些信息显示在您的网站上。 更重要的是，您可以在自己的网站中嵌入 Adobe Learning Manager 的流体播放器，以便学习者可以直接从您的网站使用内容。您能够使用流体播放器播放 Adobe Learning Manager 支持的任何内容。在您的网站中嵌入的流体播放器与在 Adobe Learning Manager 中使用的流体播放器功能完全相同。

播放任何电子学习内容

流体播放器能够以一致且直观的方式播放几乎任何类型的电子学习内容，无需任何插件，亦无需下载任何内容。 无论内容属于哪种文件类型，学习者启动内容之后，即开始播放。

备注和书签

无论内容属于哪种文件类型，您都可以为其备注并添加书签。 如果想从长文件或视频中进行选择，您可以将找到符合自己需求信息的位置标记为书签。 可以搜索备注和书签或 以 电子邮件形式发送。 单击备注和书签即可进入流体播放器，恰好位于视频或文档页面的位置。

有关 流体 播放器的更多信息，请参阅流体播放器。

以下是您可以使用嵌入式流体播放器的一些示例。

• 您可以在自己的网站中使用嵌入式流体播放器列出员工已注册的课程，并在同一页面提供启动培训的链接。 这意味着学习者可以 在 Intranet 网站上  接受培训。
• 如果您从事培训业务，您可能拥有一个网站，供客户购买课程。 您可以将嵌入式播放器与该网站集成，以便客户可以使用在您的网站上购买的内容。
  

如需构建自定义应用以在您的网站嵌入流体播放器，需执行以下三个基本步骤：

1. 在 Adobe Learning Manager 的集成管理员应用中创建应用程序。
2. 检索访问令牌。
3. 使用访问令牌通过公共 API 从 Adobe Learning Manager 检索资源。
   

1. 在“集成管理员”中创建应用程序

需执行此步骤，才能创建用于检索刷新令牌和访问令牌的应用程序/客户端 ID 和应用程序/客户端密钥。 有关创建应用程序的更多信息，请参阅应用程序开发流程。

2. 检索访问令牌

Adobe Learning Manager 使用 OAUTH2.0 时， 因此需要访问令牌 才能使用公共 API 检索资源。 您可以使用刷新令牌、客户端 ID 或客户端密钥获取访问令牌。

2.1 刷新令牌

• 检索 OAuth 代码

需要 OAuth 代码才能检索刷新令牌。 Adobe Learning Manager 在使用以下 URL 登录时，将用户重定向至带有 OAuth 代码的重定向 URL（示例应用程序的“oauthredirect.html”文件举例说明了如何提取 OAuth 代码）：

https://learningmanager.adobe.com/oauth/o/authorize
client_id= <application_id>
&redirect_uri=<redirect_uri>
&state=<dummy_data>
&scope=learner:read,learner:write
&response_type=CODE
&account=<account_id>
&email=<email_id>

在此 URL 中，client id 是第 1 步中获取的应用程序 ID。
redirect_url 是第 1 步中设置的 redirect_url。
state 是我们需要以此为依据筛选重定向 URL 以获取 OAuth 代码的任何虚拟数据。scope 是第 1 步中设置的学习者范围。
response_type 始终为“CODE”。
account 是可选字段
email 是可选字段
*如果同时提供帐户 ID 和电子邮件，则上述 URL 允许用户登录同一帐户。示例应用程序的“index.html”文件中描述了此端点示例。

• 检索刷新令牌

收到 OAuth 代码后，可以使用从以下端点接收的 OAuth 代码、客户端 ID 和客户端密钥检索刷新令牌：

https://learningmanager.adobe.com/oauth/token

作为对帖子请求的响应，您会收到以下信息：

i. refresh_token
ii. access_token
iii. user_id
iv. expires_in
v. user_role
vi. account_id

2.2 从刷新令牌中检索访问令牌

要检索访问令牌，请将包含 refresh_token、client_id 和 client_secret 的另一请求作为帖子正文发送到以下 URL：

https://learningmanager.adobe.com/oauth/token/refresh

作为对帖子请求的响应，您会收到以下信息：
i. refresh_token
ii. access_token
iii. user_id
iv. expires_in
v. user_role
vi. account_id

3. 使用公共 API 检索资源

第 3 步，您需要使用访问令牌通过公共 API 从 Adobe Learning Manager 检索资源 。  调用 任何公共 API 都需要访问令牌，且需要将其添加到标头中，如示例应用程序所示。

嵌入式播放器

第三方应用程序可以利用嵌入式播放器，播放学习对象的内容。

在嵌入式播放器中打开课程

1. 创建可嵌入的 URL

要使用嵌入式播放器打开课程，您需要创建可嵌入的 URL，如下所示：

https://learningmanager.adobe.com/app/player?lo_id=<v2-api course id>&access_token=<access_token>

在此 URL 中，lo_id 需要符合 V2 API 课程 ID 格式。

示例：https://learningmanager.adobe.com/app/player?lo_id=course:123456&access_token=45b269b75ac65d6696d53617f512450f

认证、学习计划和工作辅助也可以在嵌入式播放器中播放。

示例：https://learningmanager.adobe.com/app/player?lo_id=certification:12345&access_token=c1a4847dfbf4007826a027d481b93c1e

https://learningmanager.adobe.com/app/player?lo_id=learningProgram:12345&access_token=c1a4847dfbf4007826a027d481b93c1e

https://learningmanager.adobe.com/app/player?lo_id=jobAid:1234&access_token=c1a4847dfbf4007826a027d481b93c1e

     2. 在 iframe 的“src”属性中设置此 URL。

关闭嵌入式播放器

window.addEventListener("message", function closePlayer(){
   if(event.data === "status:close"){
     //handle closing event
   }
})；

示例应用程序教程

附件 PDF 文档包含示例应用程序教程。