苹果CMS影视模板开发常用链接函数详解

一、影片详情链接函数 {:mac_url_vod_detail($obj)}

这个函数是模板里使用频率最高的，作用是生成当前影片独立详情页面完整访问地址。

参数仅需传递影片数据对象$obj，循环列表、首页推荐、分类页海报卡片全部通用。

基础使用示例：{volist name="vod_list" id="obj"}
<a href="{:mac_url_vod_detail($obj)}">{$obj.vod_name}</a>{/volist}

二、视频播放页链接函数

1、指定集数播放地址 {:mac_url_vod_play($obj,['sid'=>1,'nid'=>1])}

第二个参数传入数组，sid代表播放分类ID，nid对应选集序号，可精准跳转到指定线路、指定剧集播放页面。

适用场景：分集列表、侧边选集弹窗、自定义多线路播放按钮。

2、默认第一集播放地址 {:mac_url_vod_play($obj,'first')}

简写写法，无需手动填写sid和nid，自动读取影片第一条播放线路的第一集链接。

适用场景：海报卡片播放按钮、首页快速播放入口，减少多余代码。

三、视频下载页链接函数

1、指定线路下载地址 {:mac_url_vod_down($obj,['sid'=>1,'nid'=>1])}

参数逻辑和播放函数完全一致，数组内sid为下载分类ID，nid为对应下载选集序号，跳转专属下载页面。

2、第一条下载线路地址 {:mac_url_vod_down($obj,'first')}

简写模式，自动调取影片第一条下载资源链接，适合页面快速下载按钮。

四、影片简介图片过滤 {$obj.vod_content|mac_url_content_img}

属于模板内容过滤标签，作用是解析影片详情介绍内容，自动补全内容里图片的完整访问路径，避免简介图片失效、无法显示。

直接放置在详情页介绍区域即可使用，无需额外参数，仅作用于vod_content影片介绍字段。

五、函数通用使用注意事项

1、所有链接函数都依赖$obj影片数据对象，仅在vod列表循环、详情页原生页面内生效，无影片数据会报错。

2、'first'简写参数仅支持播放、下载两类函数，详情链接不支持该简写方式。

3、sid、nid数字需要和后台添加的播放线路、分集序号一一对应，数字错误会出现404页面。

4、mac_url_content_img过滤器仅处理图片路径，不会修改文字内容，不会破坏原有简介排版。