Mentos: FXML all_*: channel overrides global

2026-10-28T21:24:15Z

FXML all_*: channel overrides global

Внесённые изменения

Mentos: FXML all_*: channel overrides global

2026-10-28T12:02:18Z

FXML all_*: channel overrides global

Внесённые изменения

Mentos: FXML all_*: channel overrides global

2026-10-28T11:52:12Z

FXML all_*: channel overrides global

Новая страница

{{DISPLAYTITLE:ServiceFork — плагины Tizen}}

<div class="toccolours" style="width:100%; max-width:920px; padding:12px 16px; line-height:1.55;">
'''ServiceFork''' — фоновый HTTP-сервис в приложении Fork browser на <b>Samsung Tizen</b>. Отдаёт страницы в формате '''FXML (JSON)''' с локального адреса <code>http://127.0.0.1:8092/</code>, без отдельного PHP-сервера.

См. также: [[FXML|Спецификация FXML]] · [https://appfxml.com/ Репозиторий Fork browser]
</div>

== Назначение ==

* Парсеры сайтов, каталоги и утилиты, работающие '''на TV''' (Node.js в Tizen service).
* Тот же контракт, что у веб-портала: объект с <code>title</code>, массив <code>channels[]</code>, глобальные поля (<code>css</code>, <code>typeList</code>, <code>icon</code> и др.) — см. [[FXML#3. Термины и модель данных|модель FXML]].
* Плагины подключаются файлами в каталоге <code>service/plugins/</code> проекта Tizen (в пакете приложения).

== Архитектура ==

{| class="wikitable" style="width:100%;"
! Компонент !! Описание
|-
| <code>service/index.js</code> || Ядро ServiceFork: HTTP на порту '''8092''', загрузка плагинов, общий API (<code>api.page</code>, <code>api.htmlChannel</code>, HTTP-запросы, кеш).
|-
| <code>service/plugins/<id>.js</code> || Один плагин = один модуль. Имя файла (без <code>.js</code>) = URL-путь: <code>/<id></code>.
|-
| Fork browser (UI) || Запрашивает <code>playlist_url</code> вида <code>http://127.0.0.1:8092/rezka/...</code> и отображает JSON как обычную FXML-страницу.
|}

'''Запуск сервиса (Tizen):''' background service приложения, операция <code>service</code>, пакет вида <code><packageId>.servicefork</code> (см. <code>config.xml</code> виджета). При старте вызываются <code>onStart</code> / <code>onRequest</code> из <code>service/index.js</code>.

'''Служебные URL:'''

{| class="wikitable"
! Путь !! Ответ
|-
| <code>/</code> || Список загруженных плагинов
|-
| <code>/status</code> || JSON: версия, список плагинов, плитки для стартового меню
|-
| <code>/plugins</code> || FXML-страница со списком плагинов
|-
| <code>/logs</code> || Просмотр логов service (FXML-страница)
|}

Зарезервированные id: <code>status</code>, <code>plugins</code>, <code>logs</code> — нельзя использовать как имя плагина.

== Быстрый старт: свой плагин ==

# В проекте Tizen Studio (например <code>workspace/Forkbrowser/service/plugins/</code>) скопируйте шаблон <code>_template.js</code> → <code>myparser.js</code> (файлы с префиксом <code>_</code> '''не''' загружаются).
# Задайте в начале файла объект <code>PLUGIN</code>: <code>id</code>, <code>name</code>, <code>version</code>, навигацию <code>nav[]</code>.
# Экспортируйте функцию <code>module.exports = function (api) { return { ... }; }</code> с полями:
#* <code>name</code>, <code>version</code>
#* <code>home(base)</code> — плитка на стартовом экране (через <code>api.homeTile</code>)
#* <code>routes</code> — обработчики путей: <code>''</code> (главная), <code>search</code>, <code>list</code> и т.д.
# Соберите и установите .wgt на TV. Плагин будет доступен: <code>http://127.0.0.1:8092/myparser</code>
# В FXML укажите, например: <code>"playlist_url": "http://127.0.0.1:8092/myparser"</code> или добавьте плитку через <code>/status</code> → <code>services</code>.

'''Минимальный каркас (упрощённо):'''

<pre>module.exports = function (api) {
var id = 'myparser';
return {
name: 'My Parser',
version: '1.0.0',
home: function (base) {
return api.homeTile({
id: id,
base: base,
title: 'My Parser',
playlist_url: api.pluginUrl(base, id)
});
},
routes: {
'': function (ctx, cb) {
cb(null, api.page('My Parser', [
api.folder('Раздел', api.pluginUrl(ctx.base, id, 'list'))
]));
},
list: function (ctx, cb) {
cb(null, api.page('Список', [
api.stream('Пример', 'http://example.com/video.m3u8')
]));
}
}
};
};</pre>

== API ядра (кратко) ==

Плагин получает объект <code>api</code> из <code>createApi</code> в <code>service/index.js</code>.

{| class="wikitable"
! Метод !! Назначение
|-
| <code>api.page(title, channels, extra)</code> || Готовая FXML-страница (<code>extra</code>: <code>css</code>, <code>typeList</code>, <code>icon</code>)
|-
| <code>api.folder(title, url, opts)</code> || Элемент с <code>playlist_url</code>
|-
| <code>api.stream(title, url, opts)</code> || Элемент с <code>stream_url</code>, опционально <code>parser</code>
|-
| <code>api.htmlChannel(cfg)</code> || Channel с <code>position: html</code>, <code>template</code>, <code>menu</code>, <code>search_on</code>
|-
| <code>api.homeTile(cfg)</code> || Плитка для стартового меню Tizen
|-
| <code>api.cardChannels(items, base, opts)</code> || Сетка карточек с шаблоном
|-
| <code>api.getText / api.getTextCached</code> || HTTP GET HTML (User-Agent, редиректы, таймаут)
|-
| <code>api.pluginUrl(base, id, route, params)</code> || Ссылка на свой или чужой маршрут плагина
|-
| <code>api.linkTo(base, path, params)</code> || Query-string для внутренних URL
|-
| <code>api.log.info / warn / error</code> || Логи → консоль, буфер, <code>/logs</code>
|}

'''Маршруты (<code>routes</code>):''' ключ — путь после <code>/<pluginId>/</code> (пустая строка = корень). Обработчик <code>function (ctx, cb)</code>: <code>ctx.q</code> — GET-параметры, <code>ctx.base</code> — <code>http://127.0.0.1:8092</code>, <code>cb(err, fxmlObject)</code>.

'''Прямые URL в адресной строке Fork:''' если <code>playlist_url</code> — полный <code>http(s)://...</code>, ServiceFork может перехватить запрос через <code>matchUrl</code> + <code>handleUrl</code> (см. плагины rezka, kinogo).

== Иконки и оформление ==

* Положите <code>service/plugins/<id>.png</code> (или .jpg) — ядро отдаст <code>http://127.0.0.1:8092/<id>.png</code> и подставит в плитку.
* CSS страницы: передайте в <code>api.page(..., { css: '...' })</code> — попадает в глобальный тег FXML <code>css</code>.
* Шаблоны кнопок/карточек — через <code>api.htmlChannel({ template: '...', before: '...' })</code>, плейсхолдеры <code>$title</code>, <code>$logo_30x30</code> (как в [[FXML#6. Оформление и вёрстка элементов|§6 FXML]]).

== Отладка ==

# На TV откройте в Fork: <code>http://127.0.0.1:8092/status</code> — список плагинов и версия ServiceFork.
# <code>http://127.0.0.1:8092/logs</code> — логи (уровни error/warn/info/debug).
# Ошибки загрузки плагина пишутся в log с префиксом <code>[pluginId]</code>.
# Логи также уходят в UI Fork через MessagePort (<code>servicefork-log</code>).

== Связь с FXML ==

{| class="wikitable"
! На сервере (PHP) !! ServiceFork (Tizen)
|-
| <code>$_PL</code> / <code>$_CH</code> || <code>api.page()</code> / объекты channel
|-
| <code>json_encode($_PL)</code> || <code>sendJson(res, body)</code> в HTTP-ответе
|-
| <code>playlist_url</code> на свой домен || <code>api.pluginUrl(...)</code> → localhost:8092
|}

Пользователь не видит разницы: Fork парсит JSON одинаково. Для гибридных сценариев портал может отдавать ссылки на <code>http://127.0.0.1:8092/...</code> только на Tizen (по <code>box_client</code> в GET — см. [[FXML#7.1. Параметры GET от клиента|§7.1 FXML]]).

== Примеры в проекте ==

* <code>service/plugins/_template.js</code> — шаблон нового плагина
* <code>service/plugins/rezka.js</code>, <code>kinogo.js</code> — полноценные парсеры с маршрутами, меню, поиском

== Установка приложения с ServiceFork ==

Сборка виджета и установка на Samsung Tizen — [[Браузер Fork - Wiki:Установить браузер Fork#Samsung Smart TV|инструкции по установке]] ([https://appfxml.com/ Apps2Tizen], ForkTizenInstall, .wgt).

[[Category:FXML]]

ServiceFork Tizen - История изменений

Mentos: FXML all_*: channel overrides global

Mentos: FXML all_*: channel overrides global

Mentos: FXML all_*: channel overrides global