获取设置列表 websocket测试 POST http://{{host}}/SystemSettings/getSystemSettings 响应参数 参数名 类型 描述 必填 status int 示例:200 必填 settings array 数据列表 必填 title string 设置块标题 必填 items array 数据列表 必填 title string 标题 必填 icon string 图片 icon 必填 option int 设置类型 必填 tag string 设置唯一 tag 必填 url string 二级目录请求地址 必填 selectTitle string 当前选项标题 必填 说明 / 示例 |参数(option)|说明| |-|-| |0|开关| |1|单选列表| |2|多选列表| |3|二级设置项| |4|特殊设置| ## 使用说明 ### option: 0 (开关类设置) **如:播放设置中的:记忆播放** ``` "title": "记忆播放", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_memory_playback.png", "option": 0, "tag": "SettingsItemTagBookmarks", "url": "/SystemSettings/playSettings/setBookmarks?switch=", "switchStatus": true ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_memory_playback.png++ **当前开关状态:(switchStatus字段)** "switchStatus": true **修改开关状态:(url字段)** **false:0** **true:1** **如:关闭记忆播放** http://{{host}}++/SystemSettings/playSettings/setBookmarks?switch=0++ --- ### option: 1 (单选列表类设置) **如:播放设置中的:播放模式** ``` "title": "播放模式", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_playback_mode.png", "option": 1, "tag": "SettingsItemTagPlayMode", "url": "/SystemSettings/playSettings/getPlayModeList", "selectTitle": "单文件循环" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_playback_mode.png++ **当前选择模式:(selectTitle字段)** "selectTitle": "单文件循环" **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/getPlayModeList++ ``` { "status": 200, "currentIndex": 1, "url": "/SystemSettings/playSettings/setPlayMode?index=", "data": [ { "index": 0, "title": "关闭" }, { "index": 1, "title": "单文件循环" }, { "index": 2, "title": "全部循环" }, { "index": 3, "title": "随机播放" }, { "index": 4, "title": "顺序播放" } ] } ``` **设置下级列表功能:(url字段)** **index 为列表下标** http://{{host}}++/SystemSettings/playSettings/setPlayMode?index=0++ --- ### option: 2 (多选列表类设置) **如:播放设置中的:默认语言-默认字幕下载** ``` "title": "默认字幕下载", "icon": "", "option": 2, "tag": "SettingsItemTagDefaultLanguageDownSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList", "selectTitle": "自动" ``` **当前选择模式:(selectTitle字段)** "selectTitle": "自动" **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList++ ``` { "status": 200, "currentIndexs": "[1,2]", "url": "/SystemSettings/playSettings/defaultLanguage/setDefaultDownSubtitle?indexs=", "data": [ { "index": 0, "isResetItem": true, "title": "自动" }, { "index": 1, "title": "Afrikaans" } ] } ``` **当前已选中的下标:(currentIndexs字段)** **currentIndexs: [1,2] ,表示已选中了1,2项** **设置下级列表功能:(url字段)** **indexs 为选中下标数组** http://{{host}}++/SystemSettings/playSettings/defaultLanguage/setDefaultDownSubtitle?indexs=[1,2,3,4,6]++ --- ### option: 3 (二级设置项类设置) **如:播放设置中的:默认语言** ``` "title": "默认语言", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_default_language.png", "option": 3, "tag": "SettingsItemTagDefaultLanguage", "url": "/SystemSettings/playSettings/getDefaultLanguage", "selectTitle": "" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_default_language.png++ **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/getDefaultLanguage++ ``` { "status": 200, "items": [ { "title": "默认音频", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageTrack", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultTtackList", "selectTitle": "自动" }, { "title": "默认字幕", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultSubtitleList", "selectTitle": "自动" }, { "title": "默认字幕下载", "icon": "", "option": 2, "tag": "SettingsItemTagDefaultLanguageDownSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList", "selectTitle": "Afrikaans" }, { "title": "默认强制下载", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageForcedSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultForcedSubtitleList", "selectTitle": "自动" } ] } ``` **返回的结果同主目录设置一样,请参考option字段** --- ### option: 4 (特殊设置类设置) **如:播放设置中的:音频偏移** ``` "title": "音频偏移", "icon": "/SystemSettings/getItemSettingIcon?iconName=dac_fit.png", "option": 4, "tag": "SettingsItemTagAudioOffset", "url": "/SystemSettings/playSettings/setAudioOffset?index=", "selectTitle": "0" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=dac_fit.png++ **由于此类设置比例特殊,需要通过判断tag单独处理** **请参数特殊类设置接口说明**
|参数(option)|说明| |-|-| |0|开关| |1|单选列表| |2|多选列表| |3|二级设置项| |4|特殊设置| ## 使用说明 ### option: 0 (开关类设置) **如:播放设置中的:记忆播放** ``` "title": "记忆播放", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_memory_playback.png", "option": 0, "tag": "SettingsItemTagBookmarks", "url": "/SystemSettings/playSettings/setBookmarks?switch=", "switchStatus": true ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_memory_playback.png++ **当前开关状态:(switchStatus字段)** "switchStatus": true **修改开关状态:(url字段)** **false:0** **true:1** **如:关闭记忆播放** http://{{host}}++/SystemSettings/playSettings/setBookmarks?switch=0++ --- ### option: 1 (单选列表类设置) **如:播放设置中的:播放模式** ``` "title": "播放模式", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_playback_mode.png", "option": 1, "tag": "SettingsItemTagPlayMode", "url": "/SystemSettings/playSettings/getPlayModeList", "selectTitle": "单文件循环" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_playback_mode.png++ **当前选择模式:(selectTitle字段)** "selectTitle": "单文件循环" **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/getPlayModeList++ ``` { "status": 200, "currentIndex": 1, "url": "/SystemSettings/playSettings/setPlayMode?index=", "data": [ { "index": 0, "title": "关闭" }, { "index": 1, "title": "单文件循环" }, { "index": 2, "title": "全部循环" }, { "index": 3, "title": "随机播放" }, { "index": 4, "title": "顺序播放" } ] } ``` **设置下级列表功能:(url字段)** **index 为列表下标** http://{{host}}++/SystemSettings/playSettings/setPlayMode?index=0++ --- ### option: 2 (多选列表类设置) **如:播放设置中的:默认语言-默认字幕下载** ``` "title": "默认字幕下载", "icon": "", "option": 2, "tag": "SettingsItemTagDefaultLanguageDownSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList", "selectTitle": "自动" ``` **当前选择模式:(selectTitle字段)** "selectTitle": "自动" **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList++ ``` { "status": 200, "currentIndexs": "[1,2]", "url": "/SystemSettings/playSettings/defaultLanguage/setDefaultDownSubtitle?indexs=", "data": [ { "index": 0, "isResetItem": true, "title": "自动" }, { "index": 1, "title": "Afrikaans" } ] } ``` **当前已选中的下标:(currentIndexs字段)** **currentIndexs: [1,2] ,表示已选中了1,2项** **设置下级列表功能:(url字段)** **indexs 为选中下标数组** http://{{host}}++/SystemSettings/playSettings/defaultLanguage/setDefaultDownSubtitle?indexs=[1,2,3,4,6]++ --- ### option: 3 (二级设置项类设置) **如:播放设置中的:默认语言** ``` "title": "默认语言", "icon": "/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_default_language.png", "option": 3, "tag": "SettingsItemTagDefaultLanguage", "url": "/SystemSettings/playSettings/getDefaultLanguage", "selectTitle": "" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=icon_system_setting_default_language.png++ **获取下级设置列表:(url字段)** http://{{host}}++/SystemSettings/playSettings/getDefaultLanguage++ ``` { "status": 200, "items": [ { "title": "默认音频", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageTrack", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultTtackList", "selectTitle": "自动" }, { "title": "默认字幕", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultSubtitleList", "selectTitle": "自动" }, { "title": "默认字幕下载", "icon": "", "option": 2, "tag": "SettingsItemTagDefaultLanguageDownSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultDownSubtitleList", "selectTitle": "Afrikaans" }, { "title": "默认强制下载", "icon": "", "option": 1, "tag": "SettingsItemTagDefaultLanguageForcedSubtitle", "url": "/SystemSettings/playSettings/defaultLanguage/getDefaultForcedSubtitleList", "selectTitle": "自动" } ] } ``` **返回的结果同主目录设置一样,请参考option字段** --- ### option: 4 (特殊设置类设置) **如:播放设置中的:音频偏移** ``` "title": "音频偏移", "icon": "/SystemSettings/getItemSettingIcon?iconName=dac_fit.png", "option": 4, "tag": "SettingsItemTagAudioOffset", "url": "/SystemSettings/playSettings/setAudioOffset?index=", "selectTitle": "0" ``` **获取小图标:(icon字段)** http://{{host}}++/SystemSettings/getItemSettingIcon?iconName=dac_fit.png++ **由于此类设置比例特殊,需要通过判断tag单独处理** **请参数特殊类设置接口说明**