开启音乐播放器

Vela 主题设置 · 分区：基础配置 · 上级分区：base · 选项 ID：music_switch · 类型：submessage

依赖：仅当 'music_switch', '!=', '', '', 'visible' 满足时才显示/生效。

功能简介

开启后会自动播放音乐，但是大部分浏览器都禁止自动播放，具体自测

适用场景

• 当你希望「开启后会自动播放音乐，但是大部分浏览器都禁止自动播放，具体自测」生效时，开启本设置即可，无需改动主题文件。
• 适用于需要在不写代码的前提下，快速为站点追加「开启音乐播放器」相关表现的场景。
• 若同一页面存在多个相似美化项，建议只开启其一，避免视觉冲突。

代码实现

📂 文件创建清单

无需新建任何 PHP / JS / CSS 文件。本设置是 Vela 主题设置页的一个开关，字段已写在 /zibll_child/includes/acg/sections.php（相对路径 zibll_child/includes/acg/sections.php）的「基础配置」分区（上级分区：base）。开启后，前端通过 vela_get_option('music_switch') 读取开关状态，由 includes/acg/ 模块输出对应样式类或加载美化资源。

📁 本段代码存放文件

以下 CSF 字段定义 需放在 /zibll_child/includes/acg/sections.php（zibll_child/includes/acg/sections.php）的「基础配置」分区的 fields 数组中（该项已存在，无需重复添加；若你要新增同类设置，照此格式在对应分区追加即可）。

开关注册代码（CSF 字段定义）

array(
            array(
            'type'    => 'submessage',
            'style'   => 'warning',
            'content' => '<h3 style="color:#fd4c73;">悬浮音乐播放器插件</h3>
           <p>核心代码为<a href="">阿瑞斯</a>独立开发，由<a href="">阿瑞斯</a>改自Wordpress插件，播放器目前有6种不同颜色的主题样式可任意切换 + 3种获取音乐的方式！</p>
           <p>注意：该插件代码有用到ES6语法和css3新特性，如果你使用浏览器内核还是IE10以下，那请回避吧~</p>
           <p>本插件已征得<a href="">小枫网络</a>代码引用许可</p>',
           'style' => 'warning',
           'type' => 'submessage',
        ),
        array(
            'id'    => 'music_switch',
            'type'  => 'switcher',
            'title' => '开启音乐播放器',
            'default'  => false,
        ),
        array(
            'dependency'  => array('music_switch', '!=', '', '', 'visible'),
            'id'    => 'music_fadeOutAutoplay',
            'type'  => 'switcher',
            'title' => '自动淡出音乐播放器',
            'subtitle' => '默认不淡出',
            'desc' => '开启后会自动播放音乐，但是大部分浏览器都禁止自动播放，具体自测',
            'default'  => false,
        ),
        array(
            'dependency'  => array('music_switch', '!=', '', '', 'visible'),
            'id'    => 'lyric',
            'type'  => 'switcher',
            'title' => '关闭底部歌词',
            'subtitle' => '全局',
            'desc' => '开启后将关闭底部的歌词显示',
            'default'  => false,
        ),
        array(
            'dependency'  => array('music_switch', '!=', '', '', 'visible'),
            'id'    => 'lyric_mobile',
            'type'  => 'switcher',
            'title' => '关闭底部歌词',
            'subtitle' => '手机端',
            'desc' => '开启后将关闭底部的歌词显示',
            'default'  => false,
        ),
        array(
            'dependency'  => array('music_switch', '!=', '', '', 'visible'),
            'id'    => 'suiji',
            'type'  => 'switcher',
            'title' => '随机音乐',
            'desc' => '随机播放音乐，不按照列表顺序播放',
            'default'  => false,
        ),
        array(
            'dependency'  => array('music_switch', '!=', '', '', 'visible'),
            'id'    => 'music_mobiles',
            'type'  => 'switcher',
            'title' => '手机端',
            'desc' => '要关闭手机端显示吗？',
            'default'  => false,
        ),
    )

使用示例

1. 后台 外观 → Vela主题设置 → 基础配置，找到「开启音乐播放器」开关并打开，保存设置。
2. 回到前台对应页面，即可看到效果（部分项仅 PC 端或仅子比主题生效，详见说明）。
3. 在主题或插件代码中读取该设置：

$on = vela_get_option('music_switch', false);
if ($on) {
    // 开关已开启，自定义逻辑
}