苹果CMS视频链接生成函数 mac_url_vod_detail mac_url_vod_play教程
开发教程简介
在苹果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影片简介字段,可以自动补齐简介内图片的完整URL,解决简介图片路径不全、图片空白不显示的问题,直接放在详情介绍区域即可使用,不会改动文字排版。
其他说明
所有路由函数都依赖影片对象$obj,只能在vod循环或者原生详情页使用,缺少数据对象会抛出错误。
'first'简写参数只支持播放、下载函数,影片详情链接mac_url_vod_detail不支持这个写法。
sid、nid数值必须和后台添加的播放线路、分集序号匹配,数字不对会出现404。
mac_url_content_img只修复图片地址,不会修改简介文字内容,原有排版结构保留。
