AMP
EN
Deutsch Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

重要提示：此文档不适用于您当前选择的格式stories！

amp-jwplayer

描述

显示云托管的 JW Player。

 

必需脚本

<script async custom-element="amp-jwplayer" src="https://cdn.ampproject.org/v0/amp-jwplayer-1.0.js"></script>

支持的布局

示例

width 和 height 属性决定了嵌入在响应式布局中的播放器的纵横比。

示例

<amp-jwplayer
  data-player-id="aBcD1234"
  data-media-id="5678WxYz"
  layout="responsive"
  width="16"
  height="9"
>
</amp-jwplayer>

也支持非响应式布局。

示例

<amp-jwplayer
  data-player-id="aBcD1234"
  data-playlist-id="5678WxYz"
  width="160"
  height="90"
>
</amp-jwplayer>

属性

data-player-id JW Platform 播放器 ID。这是一个 8 位数字字母序列，可以在 JW Player 仪表板的播放器部分中找到。（必需）
data-media-id JW Platform 媒体 ID。这是一个 8 位数字字母序列，可以在 JW Player 仪表板的内容部分中找到。（如果未定义 data-playlist-id，则为必需。）。注意：outstream 也是一个有效值。
data-playlist-id JW Platform 播放列表 ID。这是一个 8 位数字字母序列，可以在 JW Player 仪表板的播放列表部分中找到。如果同时指定了 data-playlist-id 和 data-media-id，则 data-playlist-id 优先。（如果未定义 data-media-id，则为必需。）
data-content-search 表示播放列表的类型。如果需要上下文文章匹配，请使用值 `__CONTEXTUAL__`。如果需要搜索播放列表，请输入用于生成搜索播放列表的关键字或短语。
data-content-backfill 确保搜索或上下文播放列表始终返回结果。如果给定的查询没有相关结果，此参数可确保改用一组热门视频。（布尔值，默认为：true）
data-player-querystring 将添加到播放器 iframe src 的参数的查询字符串。这可以用于诸如令牌签名之类的事情。
data-player-param-* 一个属性，将作为查询参数添加到播放器 iframe src。

键和值将进行 URI 编码。键将使用驼峰式命名。
  • data-player-param-token="abc" 变为 &token=abc
  • data-player-param-custom-data="key:value;key2:value2" 变为 &customData=key%3Avalue%3Bkey2%3Avalue2
是使用 data-player-querystring 的替代方法。
data-ad-cust-params 一个 JSON 字符串，表示要添加到广告标签的自定义参数。
data-ad-cust-params='{
      "key1": "value"
    }'
data-ad-macro-* 一个用于覆盖广告标签中宏的默认值的属性。支持的宏包括
  • 域
  • 引用
  • 页面 URL
  • 项目-{custparam}
  • 项目-{custparam}-列表
data-ad-macro-domain="jwplayer.com" 将改为将“jwplayer.com”替换为 __domain__ 宏。

有关更多信息，请参阅 JW Player 的广告标签定位宏。
data-config-plugin-url 一个 URL 字符串，用于将外部 JS 插件传递给播放器。
data-config-skin-url 一个 URL 字符串，用于将外部 CSS 皮肤传递给播放器。有关更多信息，请参阅 JW Player 的CSS 皮肤参考。
data-config-json 一个播放器配置的 JSON 字符串。这可以用于在播放器上设置特定的配置属性。
data-config-json='{"playbackRateControls":true,"displaytitle":false}'
也可以使用此项指定广告配置。
data-config-json='{
      "advertising": {
        "client": "vast",
        "schedule": [
          {
            "tag": "http://adserver.com/vastTag.xml",
            "offset": "pre"
          }
        ]
      }
    }'
无法使用此属性配置媒体和滚动浮动属性。在您的 JW Player 仪表板中更新媒体属性。有关更多信息，请参阅 JW Player 的播放器配置参考。
data-block-on-consent 需要 amp-consent 扩展程序。 如果存在此属性，则播放器加载将延迟到同意状态被解决为止。然后，同意数据将作为查询参数传递给播放器的 iframe，以用于广告实施。
有关更多详细信息，请参阅amp-consent文档。
自动播放 如果存在此属性并且浏览器支持自动播放，则视频将在可见后立即自动播放。组件需要满足一些播放条件，这些条件在 AMP 规范中的视频部分中进行了概述。
停靠 需要 amp-video-docking 扩展程序。 如果存在此属性并且视频正在手动播放，则当用户滚动出视频组件的视觉区域时，视频将被“最小化”并固定到角落或元素。
有关更多详细信息，请参阅关于停靠扩展程序本身的文档。
常用属性 此元素包含扩展到 AMP 组件的常用属性。

验证

请参阅 AMP 验证器规范中的amp-jwplayer 规则。

需要更多帮助？

您已经阅读此文档十几次，但它并未真正涵盖您的所有问题？也许其他人也有同样的感觉：在 Stack Overflow 上与他们联系。

前往 Stack Overflow
发现错误或缺少功能？

AMP 项目强烈鼓励您的参与和贡献！我们希望您能成为我们开源社区的长期参与者，但也欢迎您为自己特别关注的问题做出一次性贡献。

前往 GitHub