---
title: "external_video_url"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/external-video-url'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/external-video-url.md'
---

# external_video_url


    返回指定外部视频的链接。外部视频指在 SHOPLINE 之外的平台上托管的视频。

    该 filter 支持添加 URL 参数以控制视频播放行为。参数名称及取值需遵循视频源平台的定义，例如 YouTube 的 [IFrame API](https://developers.google.com/youtube/player_parameters#Parameters)。



    
`media | external_video_url(attribute=any)` 返回一个 string。
    



    
## 必选参数

        
             `media` [`external_video`](https://developer.shopline.com/zh-hans-cn/docs/sline/object/external-video.md)：外部视频媒体资源。
        
    



    
## 可选参数

        
            - `autoplay` `boolean`：是否自动播放。`true` 表示自动播放，`false` 表示不自动播放。默认为 `false`。
        
            - `controls` `boolean`：是否显示播放器控件。`true` 表示显示控件，`false` 表示不显示。默认为 `true`。
        
            - `loop` `boolean`：是否循环播放。`true` 表示循环播放，`false` 表示不循环播放。默认为 `false`。
        
    



    
## 例子

        
            

            使用该 filter 解析视频链接并应用特定的播放参数，再结合 [external_video_tag](https://developer.shopline.com/zh-hans-cn/docs/sline/tag/external-video-tag.md) 渲染 YouTube 视频播放器。




            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#for media in product.media}}
    {{#switch media.media_type}}
        {{#case "external_video" /}}
            {{#if media.host == "youtube"}}
                {{#external_video_tag media | external_video_url(autoplay=false, loop=true) /}}
            {{/if}}
    {{/switch}}
{{/for}}
```
</SlineExample>