You need to enable JavaScript to run this app. Shopify Video & Feature Media开发:如何单独展示产品视频媒体
优惠活动
大模型
产品
解决方案
定价
更多

Shopify Video & Feature Media开发:如何单独展示产品视频媒体

实现方案

核心逻辑说明

Shopify的product.media是严格按照后台媒体上传顺序排序的数组,索引从0开始计数:

  • 索引0位置 = 第一个上传的媒体,和你定义的“特色图片”规则完全匹配
  • 索引1位置 = 第二个上传的媒体,就是你需要固定展示的视频

之前无法正确提取视频的常见原因有两个:一是修改时把视频提取逻辑直接合并到原有featured_media的赋值链路里,替换了特色图的渲染源,导致图片位置出视频、视频位置为空;二是没有做边界判断,遇到媒体数量不足的产品直接触发Liquid渲染报错。

具体代码修改

1. 变量定义调整

完全保留原有特色图片的赋值逻辑,新增独立的视频媒体提取变量,加两层判断避免空值报错:

{%- comment -%} 原有特色图片逻辑保留,无需修改 {%- endcomment -%}
{%- assign featured_media = product.selected_or_first_available_variant.featured_media | default: product.featured_media -%}

{%- comment -%} 新增第二个媒体提取,加边界判断 {%- endcomment -%}
{%- assign product_video_media = nil -%}
{%- if product.media.size >= 2 -%}
  {%- assign candidate_media = product.media[1] -%}
  {%- if candidate_media.media_type == 'video' or candidate_media.media_type == 'external_video' -%}
    {%- assign product_video_media = candidate_media -%}
  {%- endif -%}
{%- endif -%}

2. 媒体渲染逻辑调整

去掉原代码中全量循环所有媒体的逻辑,改成在模板对应位置分别传入指定媒体对象渲染。注意Shopify自带的media snippet会自动根据传入的媒体类型判断渲染图片还是视频,不需要单独编写视频渲染逻辑:

{%- comment -%} 模板需要展示特色图片的位置,调用图片渲染 {%- endcomment -%}
{% if featured_media %}
  {% include 'media', 
    media: featured_media, 
    featured_media: featured_media, 
    height: height, 
    enable_image_zoom: enable_image_zoom, 
    image_zoom_size: product_image_zoom_size, 
    image_scale: product_image_scale 
  %}
{% endif %}

{%- comment -%} 模板需要展示产品视频的位置,调用视频渲染 {%- endcomment -%}
{% if product_video_media %}
  {% include 'media', 
    media: product_video_media, 
    featured_media: featured_media, 
    height: height, 
    enable_image_zoom: false, 
    image_zoom_size: product_image_zoom_size, 
    image_scale: product_image_scale 
  %}
{% endif %}

3. 兜底逻辑保留

原代码里的noscript无脚本环境兜底逻辑完全保留,不需要做任何修改:

<noscript>
  {% capture product_image_size %}{{ height }}x{% endcapture %}
  <img 
    src="{{ featured_media | img_url: product_image_size, scale: product_image_scale }}" 
    alt="{{ featured_media.alt }}" 
    id="FeaturedMedia-{{ section.id }}" 
    class="product-featured-media" 
    style="max-width: {{ height }}px;"
  >
</noscript>

注意事项

  • 不要将视频提取的逻辑合并到featured_media的赋值管道中,否则会直接替换特色图片的渲染数据源,导致展示位置错乱
  • 代码中加的两层判断可以自动兼容媒体数量不足、第二个媒体非视频类型的产品,不会出现渲染报错
  • 视频渲染位置关闭了图片缩放交互参数,避免视频元素触发不匹配的交互效果

内容的提问来源于stack exchange,提问作者JulienA

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 18:45:03