FXML

Материал из Браузер Fork - Wiki
Версия от 12:22, 20 июня 2026; Mentos (обсуждение | вклад) (Добавлены разделы из CHANGELOG: ping, poster, subtitles, iframe и др.)
Перейти к навигации Перейти к поиску

FXML (Fork eXtensible Markup Language) - что такое

Это язык разметки документов во Всемирной паутине. Для навигации по таким страницам не требуется мышь или сенсорный экран. Язык FXML интерпретируется такими приложениями как ForkPlayer, OTT Player, OTT-play. Полученный в результате интерпретации форматированный текст отображается на экране телевизора.

Например, следующий код (должен быть валидным JSON):

{"title":"COOLTV - портал нового поколения","background-image":"http://cooltv.info/img/tvcool.jpg","typeList":"start","icon":"http://cooltv.info/img/tvcool23.jpg","channels":[{"title":"Вход","logo_30x30":"http://cooltv.info/img/profle22.jpg","playlist_url":"http://cooltv.info/auth"},{"title":"Новости ","logo_30x30":"http://cooltv.info/img/rss-96.png","playlist_url":"http://cooltv.info/news"},{"title":"Поиск ","logo_30x30":"http://cooltv.info/img/icons8-search-folder-96.png","playlist_url":"http://cooltv.info/media/search.php"},{"title":"Кинозал ","logo_30x30":"http://cooltv.info/img/1icons8-film-reel-96.png","playlist_url":"http://cooltv.info/media"},{"title":"AceStream ","logo_30x30":"http://cooltv.info/img/icons8-wave-arrows-96.png","playlist_url":"http://cooltv.info/vdt/12"},{"title":"Обменник ","logo_30x30":"http://cooltv.info/img/icons8-next-100.png","playlist_url":"http://cooltv.info/media/obmen/"},{"title":"Сервисы ","logo_30x30":"http://cooltv.info/img/icons8s3-96.png","playlist_url":"http://cooltv.info/vdt/9"},{"title":"IPTV ","logo_30x30":"http://cooltv.info/img/icons8-hdtv-96.png","playlist_url":"http://cooltv.info/vdt/8"},{"title":"Мультимедиа ","logo_30x30":"http://cooltv.info/img/icons8-documentary-96.png","playlist_url":"http://cooltv.info/vdt/7"},{"title":"Чат ","logo_30x30":"http://cooltv.info/img/icons8-chat-96.png","playlist_url":"http://cooltv.info/guest"},{"title":"FAQ ","logo_30x30":"http://cooltv.info/img/icons8-info-popup-96.png","playlist_url":"http://cooltv.info/faq/"},{"title":"Копилка","logo_30x30":"http://cooltv.info/img/icons8-bad-piggies-96.png","playlist_url":"http://cooltv.info/copilka"}]}

даст такой результат (в ForkPlayer):


Все допустимые команды можно посмотреть в исходном коде страниц

https://github.com/vengo634/kino.pub_forkplayerPHP/blob/master/index.php

Смотреть Исходный код любой страницы можно непосредственно в ForkPlayer


и FXML CMS


FXMLbaseparser PHP класс упрощающий верстку кода для Fork browser

FXMLbaseparser PHP класс

Новые теги и команды FXML

Новые спецификации FXML добавляются в CHANGELOG, рекомендуем смотреть нужные команды также и там.

Краткий указатель по разделам этой страницы:

Глобальные теги

$_PL["css"]="start"; // Плиточный + другой(с использованием $_CH["position"] ) виды страницы

Стили сайта по умолчанию

По умолчанию для вашей страницы задаются такие стили (вы их можете изменить задав нужные в $_PL["css"]

Смотреть CSS стили по умолчанию
-webkit-scrollbar-button:single-button {
   background-color: #bbbbbb;
   display: block;
   border-style: solid;
   height: 10px;
   width: 10px;

}

-webkit-scrollbar-button:single-button:vertical:decrement {
   border-width: 5px;
   border-color: transparent transparent #555555;

}

-webkit-scrollbar-button:single-button:vertical:increment {
   border-width: 5px;
   border-color: #555555 transparent transparent transparent;

}

-webkit-scrollbar {
   width: 10px;

}

-webkit-scrollbar-track {
   background: #ddd;

}

-webkit-scrollbar-thumb {
   background: #888;

}

-webkit-scrollbar-thumb:hover {
   background: #777;

}

.start { 

   position: relative;
   border: 0px;
   text-align: center;
   display: inline-block;
   ;
   overflow: hidden;
   text-align: center;
   margin-left: 4px;
   margin-top: 1px;
   height: 10px;
   width: 10%;

}

.start .rating { 

   position: absolute;
   display: none;
   text-align: left;
   height: 23px;
   width: 28px;
   padding-top: 5px;
   padding-left: 5px;
   font-size: 11px;

}

.start .icon { 

   padding: 2px 2px 0px 2px;
   height: 76%;

}

.start .name { 

   font-size: 17px;
   line-height: 0.9;
   position: absolute;
   bottom: 0px;
   width: 100%;
   max-height: 50%;

}

.start .title { 

   background: rgba(0, 0, 0, 0.65);
   border-radius: 3px;
   width: auto;
   display: display: inline-block;
   margin: 2px;
   padding: 1px 4px 4px 4px;

}

.start .side_icon { 

   position: relative;
   padding: 2px;

}

.list { 

   text-align: left;
   border-radius: 4px 0px 0px 4px;
   cursor: default;
   margin: 2px 0px;
   width: 48.87708333333334%;
   height: 35px;

}

.list .contmenu { 

   position: relative;
   float: right;
   display: none;

}

.list .numb { 

   float: left;
   padding-top: 2px;
   font-size: 60%;
   min-width: 38px;
   text-align: center;

}

.list .icon { 

   margin: 0px 2px;
   padding-right: 2px;
   float: left;

}

.list .title { 

   display: inline-block;
   float: left;
   position: relative;
   white-space: nowrap;

}

.listsearch { 

   background-color: #ddd;
   color: #333;
   overflow: hidden;
   border-radius: 4px;
   padding: 3px;
   margin-top: 2px;
   font-size: 85%;
   width: 90%;
   height: 68%;

}

.infolinktitle { 

   height: 63%;
   font-size: 80%;
   overflow: hidden;

}

.infolink { 

   padding-left: 3px;
   font-size: 11px;

}

.default .contmenu { 

   display: none;

}

.selected .contmenu { 

   display: block;

}

.html { 

   position: relative;
   display: inline-block;
   vertical-align: top;

}

.hlink { 

   position: relative;
   border: 0px solid transparent;
   margin: 0px 4px;
   border-radius: 4px;
   display: inline-block;
   overflow: hidden;

}

.hlink .title { 

   overflow: hidden;
   max-width: 310px;
   font-size: 90%;
   padding: 0px 4px;
   float: left;
   height: 28px;
   text-decoration: underline;

}

.hlink .icon { 

   float: left;
   height: 22px;
   padding-top: 5px;

}

.fulleditline { 

   border: 1px solid transparent;
   width: 80%;
   margin: 1px 9%;
   border-radius: 4px;
   display: inline-block;
   overflow: hidden;

}

.fulleditline .title { 

   overflow: hidden;
   font-size: 24px;
   height: 24px;
   margin: 3px;
   color: #2b2525;
   background-color: #eee;
   padding: 4px;

}

.fulleditline .icon { 

   float: right;
   height: 22px;
   padding-top: 2px;

}

.label { 

   position: relative;
   text-align: left;
   border-radius: 4px;
   margin: -2px 4%;
   font-size: 80%;
   width: 92%;
   display: inline-block;
   overflow: hidden;
   height: 26px;

}

.label .icon { 

   float: left;
   height: 20px;

}

.default { 

   background: none;

}

.selected { 

   background: rgba(180, 180, 180, 0.7);

}

.listselected { 

   color: black;

}

.site { 

   height: 100%;
   width: 100%;
   overflow-y: auto;
   overflow-x: hidden;
   font-size: 27px;

}

body { 

   color: rgb(238, 238, 238);
   margin: 0px;
   padding: 0px;
   height: 100%;
   width: 100%;
   overflow: hidden;
   background-color: transparent;

}

small { 

   font-size: 70%;
   color: gray;

}

.buttons { 

   position: fixed;
   top: 80%;
   left: 50%;
   width: 47%;
   margin: 2px;
   display: none;
   padding: 0px 3px 0px 3px;
   color: #cccccc;
   font-size: 80%;

} \#description { 

   top: 0px;
   position: fixed;
   margin: 2px;
   overflow-x: hidden;
   overflow-y: auto;
   display: none;
   padding: 0px 3px 0px 3px;
   font-size: 28px;
   left: 51%;
   width: 47.2%;
   word-break: break-word;

}

Пример своего стиля (пишите чистый css, он будет преобразован в одну строку)

Если строка стилей очень большая, их лучше вынести в отдельный css файл

$_PL["link"][]=["type"=>"text/css","href"=>"http://example.com/main.css"];

#content - стиль страницы (без description)

$_PL["css"]

#rightHalf- стиль description

$_PL["css"]="#content {font-size:25px;} #rightHalf{font-size:10 px;} "; // Установим размер шрифта сайта и описания

.selected - стиль при выделении элемента

$_PL["css"]=" .selected { color: black; } "; // Делаем смену цвета выделенного элемента

.default - стиль невыделенного элемента

$_PL["css"]=" .default{ color: gray; } ";

.contmenu - визуальная кнопка контекстного меню

$_PL["css"]=" .contmenu{ display:none; } "; // Скрываем кнопку контекстного меню

.label, .start, .list, .fulleditline, .hlink, .html - стили(верхний уровень) для разных типов элементов $_CH["position"] [1]

Если не задан $_CH["position"] элемента то по умолчанию элементы отображаются на странице списком и классом .list

Если при этом задано отображение плиткой ($_PL["typeList"]="start" ) то по умолчанию элементы отображаются с классом .start

.labelselected, .startselected, .listselected, .fulleditlineselected, .hlinkselected, .htmlselected - стили(верхний уровень) для выделенных элементов

Установим цвет для выделенных элементов только .list

$_PL["css"]=" .listselected{color: red; }";

.labeldefault, .startdefault, .listdefault, .fulleditlinedefault, .hlinkdefault, .htmldefault - стили(верхний уровень) для невыделенных элементов

.list - зададим свой вид списка

$_PL["css"]=" .list{color: red; }"; // Меняем цвет

.title .icon .rating .numb вложенные в верхний уровень стили заголовка, иконки, рейтинга(для .start), порядкового номера(для .list)

$_PL["css"]=" .title{color: red; }"; // Меняем цвет заголовков

$_PL["css"]=" .numb { display:none; } "; // Скрываем отображение номера

Комбинация классов, зададим стиль иконок только для списка (.list)

$_PL["css"]=" .list .icon{background-color:white; margin:2px;}"; // Зададим белую рамку фона для иконок


$_PL["cacheinfo"]="nocache"; // Не кешировать страницу (при возврате назад страница будет грузиться заново по адресу)

$_PL["setcookie"]["name1"]="value1"; // Аналог cookie вебсайтов. Запомнит для последующих запросов страниц с этого же домена в переменной $_GET["cookie"]["name1"] значение value1

$_PL["info"]="Вам уведомление"; // Показывает alert "Вам уведомление" с кнопкой ОК (закрыть)

$_PL["confirm"]=["title"=>"Открыть вложенный CHannel?","channel"=>["playlist_url"=>"http://.."]];

cmd тег (как глобальный так и в playlist_url) - допустимые команды

Примеры использования cmd в глобальном теге

$_PL["cmd"]="historyback(1);" // Вернуться назад на 1 страницу

$_PL["cmd"]="info(Вам уведомление);" // Показывает alert "Вам уведомление" с кнопкой ОК (закрыть)

$_PL["cmd"]="settitle(2, Новый заголовок);" // элементу 2 дать новый title

$_PL["cmd"]="setdescription(2, Новый заголовок);" // элементу 2 дать новый description

$_PL["cmd"]="reload(2);" // Перезагрузить страницу через 2секунды

В конец cmd к командам выше можно добавить stop(); чтобы выполнить команду выше и остановить загрузку новой страницы

например $_PL["cmd"]="info(Доступ к этой странице Вам запрещен);stop();" выведет уведомление но оставить пользователя на предыдущей странице.

Примеры использования cmd в $_CH["playlist_url"]

$_CH["playlist_url"]="cmd:<Команда из списка допустимых>";

Например $_CH["playlist_url"]="reload();"; перезагрузит страницу при нажатии

Глобальный тег ping

Для выполнения действий когда они станут доступны. Например в Fork browser можно отслеживать введение кода с телефона и автоматически загружать страницу.

$_PL["ping"]["link"]="http://example.com/check.php?hash";

Если check.php отдаёт пустой ответ, Fork продолжает проверять страницу каждые 6 сек.

Если check.php отдаёт страницу с channels, загружается она, например:

$_PL["channels"]=[["location"=>1,"title"=>"Успешно вошли! Нажмите для переадресации...","playlist_url"=>"http://example.com/"]];

Глобальный тег align

Выравнивание элементов при виде плиткой ($_PL["typeList"]="start"). По умолчанию — по центру.

$_PL["align"]="left";

Глобальный тег url_tvg — своя телепрограмма

Поддерживается только формат xmltv (сжатый и нет).

$_PL["url_tvg"]="http://epg.it999.ru/edem.xml.gz";

В M3U плейлисте аналогичный параметр задаётся в начале:

#EXTM3U url-tvg="http://epg.it999.ru/edem.xml.gz"

Глобальный тег aside для вывода бокового меню

Пример бокового меню Fork

$_PL["aside"]["channels"][]=["title"=>"Home","playlist_url"=>"http://site.com/","style"=>"color:blue;","logo_30x30"=>"https://static.vecteezy.com/system/resources/thumbnails/022/013/913/small/home-icon-illustration-image-vector.jpg"];

$_PL["aside"]["channels"][]=["title"=>"Category 1","playlist_url"=>"http://site.com/cat1","logo_30x30"=>"https://static.vecteezy.com/system/resources/thumbnails/022/013/913/small/home-icon-illustration-image-vector.jpg"];

Изменить стили бокового меню по умолчанию:

$_PL["css"].=""#aside{position:absolute;z-index:1;top:0px;left:0px;height:inherit;border-radius: 0px 10px 10px 0px;padding:0px 10px 0px 2px;font-size: 27px;line-height: 27px;white-space: nowrap;overflow-x: hidden;}

#aside img{width:27px;height:27px;margin-right:8px;}

.aside_default{margin:5px 0px;padding: 4px;border-radius: 8px;border: 2px solid transparent;}

.aside_selected{margin:5px 0px;padding: 4px;border-radius: 8px;border: 2px solid #5590e7;}

.aside_hide{width:30px;background:none;overflow-y: hidden;}

.aside_show{width:auto;overflow-y: auto;background-color:rgba(0, 0, 0, 0.8);}";

Если стили свои, то лучше вынести их в отдельный css файл

Подключения css файлов стилей

$_PL["link"][]=["type"=>"text/css","href"=>"http://example.com/main.css"];

advertising для показа рекламы перед запуском видео

Видеоролик

$_PL["advertising"]=["client"=>"video",
   "title"=>"Реклама",// Надпись внизу с названием или описанием обьявления
   "skip"=>3,//Добавьте skip в секундах когда можно будет нажать кнопку пропуск
   "tag"=>"https://mlb2.adriver.ru/mf/0008908/0008908282/0/720_480.mp4"
];

VAST

XML формат рекламы. Поддерживаются перенаправления, пропуск, отправка событий 

$_PL["advertising"]=["client"=>"vast",
   "title"=>"Реклама",
   "tag"=>"https://raw.githubusercontent.com/InteractiveAdvertisingBureau/VAST_Samples/master/VAST%203.0%20Samples/Inline_Companion_Tag-test.xml" 
];

В настройках форка для тестирования включите Ads: always

Channel теги

title

Заголовок

playlist_url или stream_url

Адрес страницы или адрес видеопотока (непустым может быть только один из этих тегов)

Параметры ссылок #direct и #stream_url

Добавляются в конец ссылки:

#direct — если сайт требует чистой ссылки без добавлений Fork (параметры, cookie, идентификатор):

http://pastebin.com/yuUtYu56g#direct → откроется как http://pastebin.com/yuUtYu56g

#stream_url — ссылка откроется сразу в видеоплеере.

AddFavorite и AddSearch

Команды в playlist_url для добавления портала в закладки или глобальный поиск:

$_CH[]=["logo_30x30"=>"none","title"=>"Добавить этот портал в закладки / стартовое меню","playlist_url"=>"AddFavorite(Кинопаб,https://kino.pub/images/logo.png,http://195.88.208.101/kinopub/);"];

$_CH[]=["logo_30x30"=>"none","title"=>"Добавить этот портал в Глобальный поиск","playlist_url"=>"AddSearch(Кинопаб,https://kino.pub/images/logo.png,http://195.88.208.101/kinopub/?cat=search);"];

(пример всей страницы на PHP: Кинопаб)

iframe — вставка содержимого другой страницы

На место элемента списка вставляется содержимое из ссылки. Можно использовать для поиска по нескольким плейлистам (глобальный поиск).

$_CH[]=["title"=>"Поиск Terminator в filmix.red","playlist_url"=>"https://filmix.red/fork/search?search=Terminator","iframe"=>"4","timeout"=>8];

iframe — обязательный параметр. Число — сколько ссылок из дочерней страницы показать сразу; остальное будет внизу списка. "iframe"=>"0" — показать все.

timeout — таймаут ожидания содержимого из дочерней ссылки (секунды).

Альтернативный playlist_url2, время ожидания таймаута, способы получения

Можно указать запасной источник страницы, время ожидания таймаута, способы получения 

<?php
$_CH[]= [
   "title" => "Каталог",
   "playlist_url" => "http://domain1.in.net/",
   "playlist_url2" => "http://domain2.in.net/",
   "playlist_url3" => "http://domain3.in.net/",
   "cors" => "directnoheader", // Тип получения страницы(напрямую без заголовков). Если не указать то будет перебор direct, directnoheader, remotefork и потом альтернативный источник
   "timeout" => 4, // В секундах
   "error" => "http://domainstat.in.net//err.php?info=%INFO" // Адрес куда отправлять ошибку если все страницы не откроются
];


stream_url мультиссылки с разными качествами и (или) несколькими источниками, Err format json link

Для видеопотока можно задавать мультиссылки с разным качеством (можно и разные озвучки, но это будет не так явно для пользователя), выбор качества будет браться автоматически с настроек Fork(1080 или 720 и т.д.) и (или) несколькими источниками

Пример использования в PHP с json_encode В данном примере создается массив с различными ссылками на видеопотоки, и с помощью функции json_encode он преобразуется в JSON-формат для последующего использования: 

<?php
// Массив с данными для разных качеств видео и двумя источниками
$stream_links = [
   "360" => [
       "title" => "360p",
       "url" => [
           "http://server.in/240.mp4",
           "http://server2.in/hls/240.mp4"
       ]
   ],
   "720" => [
       "title" => "720p",
       "url" => [
          "http://server.in/720.mp4",
          "http://server2.in/hls/720.mp4"
       ]
   ]
];
// Преобразование массива в JSON
$json_stream_url = json_encode($stream_links);
// Использование JSON в $_CH["stream_url"]
$_CH["stream_url"] = $json_stream_url;
// Вывод JSON для проверки
echo $_CH["stream_url"];
?>


Пример с несколькими источниками: 

<?php
$stream_links = [
           "http://server.in/240.mp4",
           "http://server2.in/hls/240.mp4"
       ];
// Преобразование массива в JSON
$json_stream_url = json_encode($stream_links);
// Использование JSON в $_CH["stream_url"]
$_CH["stream_url"] = $json_stream_url;
// Вывод JSON для проверки
echo $_CH["stream_url"];
?>

Поддержка ссылок Яндекс.Диска

Ссылка должна быть в поле stream_url или в m3u плейлисте в формате https://yadi.sk/i/idfile

playlist — похожие видео после окончания (YouTube)

<?php $PLAYLIST=[]; $PLAYLIST[]=["title"=>"Похожее видео 1","stream_url"=>"http://www.youtube.com/watch?v=ZNLZla2xHUQ"]; $PLAYLIST[]=["title"=>"Похожее видео 2","stream_url"=>"http://www.youtube.com/watch?v=ZNLZla2xHUQ"]; $_CH[]=["title"=>"Основное видео","stream_url"=>"http://www.youtube.com/watch?v=xhFCmwrSxCU","playlist"=>$PLAYLIST]; $_PL["channels"]=$_CH; print json_encode($_PL); ?>

logo_30x30

Адрес иконки

Теги видеоплеера poster, label, information

Нужны чтобы по-разному выдавать информацию на сайте и в видеоплеере.

$_CH["title"]="Хало 1 сезон 1 серия"; $_CH["label"]="Хало"; $_CH["information"]="1 сезон 1 серия";

Вид экрана плеера

Плеер сначала ищет значение в специализированном теге; если он пустой — берёт из общего тега.

Картинка в видеоплеере слева внизу

$_CH["poster"]="http://example.com/videoposter.png";

если пустой — используется logo_30x30.

Название над полосой прогресса

$_CH["label"]="Хало";

если пустой — используется title.

Информация под прогрессом

$_CH["information"]="1 сезон 1 серия";

если пустой — используется description.

Тег subtitles — субтитры

$_CH["subtitles"][0]=["UA","https://tortuga.wtf/player/subtitle/18625_ua.vtt"]; $_CH["subtitles"][1]=["EN","https://tortuga.wtf/player/subtitle/18625_en.vtt"]; $_CH["subtitles"][2]=["RU","https://tortuga.wtf/player/subtitle/18625_ru.vtt"];

event — события видеоплеера

Отправка на сервер событий при старте и остановке видео:

$_CH[]=["logo_30x30"=>"hidden","title"=>"Video","stream_url"=>"http://...","event"=>["onstartvideo"=>"$siteurl/?event=onstartvideo&videoid=1","onstopvideo"=>"$siteurl/?event=onstopvideo&curTime=[curTime]&totalTime=[totalTime]&videoid=1"]];

[curTime] и [totalTime] заменяются на время остановки и общую длительность видео в секундах.

start_time — начало воспроизведения

$_CH[]=["logo_30x30"=>"hidden","title"=>"Video","stream_url"=>"http://...","start_time"=>340];

start_time — время в секундах. Предлагается на кнопке Play только если пользователь ранее не смотрел это видео; иначе нужно отметить видео непросмотренным в Меню / Отметить непросмотренным.

confirm - диалоговое окно с действиями при нажатии на элемент

Пример подтверждения выхода с аккаунта

$_CH[]=["title"=>"Выйти","playlist_url"=>"confirm","confirm"=>["http://host/?do=exit"],"description"=>"Выйти с аккаунта?"];

menu — контекстное меню элемента channel

Массив $_CH["menu"] задаёт контекстное меню одного элемента списка (channels[]). Каждый пункт меню — мини-channel: title, playlist_url (или stream_url) и опциональные поля оформления.

Тег Область Назначение
$_CH["menu"] Элемент списка Меню конкретного channel (качество, реакция, настройка строки)
$_PL["menu"] Страница целиком Глобальная полоса меню вверху страницы (зеркала, навигация портала)

Содержание раздела

menu — быстрый старт

Минимальное вертикальное popup-меню по OK на channel: 

$menu = [];
$menu[] = ["title" => "Пункт 1", "playlist_url" => "http://example.com/1"];
$menu[] = ["title" => "Пункт 2", "playlist_url" => "http://example.com/2"];

$_CH["title"]  = "Настройки";
$_CH["playlist_url"] = "menu";   // обязательно для открытия меню
$_CH["menu"]    = $menu;

Обязательные условия:

  • у channel: "playlist_url": "menu";
  • массив menu с одним и более пунктов;
  • каждый пункт — обычный channel (URL, cmd:..., submenu и т.д.).

menu — режимы отображения

Поведение определяется комбинацией menu[0].type и наличия $menu в $_CH["template"].

Режим Условие Вид Как открыть
Popup (вертикальный) нет inline в type Список поверх страницы OK на channel с playlist_url":"menu"
Inline в строке type содержит inline + в template есть $menu Горизонтальный ряд кнопок внутри элемента Кнопки видны сразу; popup не открывается
Inline popup inline + в template нет $menu Горизонтальный popup OK на channel; навигация ←/→

Схема подключения inline в template:

  1. $_CH["position"] = "html";
  2. В template — плейсхолдер $menu
  3. Заполнить menu[]
  4. У первого пункта: "type": "inline" (и при необходимости |nocancel)

menu — опции type

Поле type задаётся только у первого пункта menu[0]. Несколько опций комбинируются через | (порядок не важен): 

"type": "inline"
"type": "inline|nocancel"
"type": "nocancel"
Значение Описание
inline Горизонтальное меню: в строке ($menu в template) или горизонтальный popup
nocancel Не добавлять пункт «Отмена» в popup; закрытие — кнопкой Назад

Примечание: при inline первый пункт меню — обычная кнопка (например «1080p»), а не пустой служебный маркер.

menu — навигация

Контекст Клавиши Действие
Popup (вертикальный) ↑ / ↓ Перемещение между пунктами
Popup OK Выбор пункта
Popup Назад Закрыть меню (без перехода по истории)
Inline popup ← / → Перемещение между пунктами
Inline в строке ($menu) OK / клик Выбор пункта напрямую
Inline в строке ← / → Фокус по горизонтальному ряду (если меню в popup после OK)

Поле default — начальный фокус при первом открытии меню: 

"menu": [
  {"title": "Отлично", "playlist_url": "..."},
  {"title": "Нормально", "default": 1, "playlist_url": "..."},
  {"title": "Плохо", "playlist_url": "..."}
]
  • у пункта с "default": 1 (или любое истинное значение) курсор ставится при открытии;
  • если ни у одного пункта нет default — выделяется первый (индекс 0);
  • работает в popup-меню и во вложенном submenu;
  • пункт «Отмена» в фокус по default не попадает.

Поле hint — подсказка у пункта в popup: появляется через 1 с после фокуса, скрывается через 5 с (жёлтый tooltip у элемента).

menu — встраивание $menu

Пример JSON (переключатель качества): 

{
  "title": "Качество",
  "position": "html",
  "playlist_url": "menu",
  "template": "<div class='setting-item'><div class='setting-title'>$title</div><div class='chmenu'>$menu</div></div>",
  "menu": [
    {
      "type": "inline|nocancel",
      "title": "1080p",
      "logo_30x30": "http://example.com/icons/hd.png",
      "playlist_url": "http://example.com/?q=1080",
      "default": 1,
      "class": "pill active",
      "hint": "Full HD",
      "template": "<div><img src=$logo_30x30> $title</div>"
    },
    {"title": "720p", "playlist_url": "http://example.com/?q=720", "class": "pill"},
    {"title": "480p", "playlist_url": "http://example.com/?q=480", "class": "pill"}
  ]
}

Пример PHP: 

<?php
$_CH["title"] = "Качество";
$_CH["position"] = "html";
$_CH["playlist_url"] = "menu";
$_CH["template"] = '<div class="setting-item">'
  . '<div class="setting-title">$title</div>'
  . '<div class="chmenu">$menu</div></div>';

$_CH["menu"] = [
  [
    "type" => "inline|nocancel",
    "title" => "1080p",
    "default" => 1,
    "logo_30x30" => "http://example.com/icons/hd.png",
    "playlist_url" => "http://example.com/?q=1080",
    "class" => "pill active",
    "template" => '<div><img src=$logo_30x30> $title</div>'
  ],
  ["title" => "720p", "playlist_url" => "http://example.com/?q=720", "class" => "pill"],
  ["title" => "480p", "playlist_url" => "http://example.com/?q=480", "class" => "pill"]
];

$_PL["css"] = ".pill{border-radius:999px;padding:4px 14px;margin:0 4px;display:inline-block;}"
  . ".pill.active{background:#3366cc;color:#fff;}";
$_PL["channels"][] = $_CH;
print json_encode($_PL);
?>

При $menu в template + type:inline повторный popup по OK не открывается.

menu — справочник полей

Поле Тип Описание
title string Текст пункта (обязательно для отображения)
playlist_url string URL или команда при выборе (cmd:..., submenu и др.)
stream_url string Альтернатива playlist_url для видеопотока
type string — inline, nocancel
default int/bool 1 — пункт выделен при первом открытии меню
logo_30x30 string URL иконки пункта
class string CSS-класс обёртки (по умолчанию menucontext)
style string Inline-стили обёртки пункта
img_style string Inline-стили иконки (если нет своего template)
template string Свой HTML тела пункта (как у channel)
before / after string HTML до / после пункта
hint string Подсказка при фокусе в popup (1 с задержка, 5 с показ)
menu array Вложенное подменю (см. Подменю)

menu — плейсхолдеры template

Используются в template пункта menu (не путать с $menu в template channel):

Плейсхолдер Подставляется
$title title пункта
$description description пункта
$logo_30x30 URL иконки (для атрибута src)
$logo Готовый тег <img>
$class Значение class пункта
$index Индекс пункта в menu (с 0)

Плейсхолдер channel: $menu — в $_CH["template"]; подставляется HTML всех пунктов inline-меню.

menu — подменю

Пункт с вложенным списком через playlist_url":"submenu" и массив submenu: 

{
  "menu": [
    {
      "type": "inline",
      "title": "Ещё ▾",
      "playlist_url": "submenu",
      "submenu": [
        {"title": "Обновить", "playlist_url": "cmd:reload();"},
        {"title": "Настройки", "default": 1, "playlist_url": "http://example.com/settings"}
      ]
    }
  ]
}

Во встроенном $menu клик по такому пункту открывает подменю; для пунктов submenu также поддерживается default.

menu — ответ сервера cmd без перехода

Если пункт menu ведёт на URL, сервер может вернуть JSON с командой вместо новой страницы — пользователь остаётся на текущем списке, история не растёт. 

{"cmd": "seticon([index],http://example.com/icon.svg);stop();"}
Команда Назначение
seticon(индекс, url) Обновить logo_30x30 / icon channel; [index] — текущий выделенный элемент
settitle(индекс, текст) Изменить заголовок channel по индексу
stop() Прервать загрузку «новой страницы»; остаться на текущей (обязательно в конце цепочки cmd)

Типичный сценарий (реакция, переключатель без перезагрузки):

  1. Пункт menu → playlist_url с параметром действия (например &react=1)
  2. Сервер сохраняет данные и отвечает: {"cmd":"seticon([index],URL_иконки);stop();"}
  3. Fork обновляет иконку строки; кнопка Назад сразу уходит на предыдущую страницу (без «лишнего» шага)

См. также глобальный тег cmd и stop(); в $_PL["cmd"].

menu — стилизация

  • Оформление пунктов — через class, style, template каждого пункта.
  • Общие стили (pill, tab, badge) — $_PL["css"] или внешний файл $_PL["link"][].
  • Длинное inline-меню прокручивается по горизонтали (overflow-x).

menu — совместимость

Channel с menu без type:inline и без $menu в template работает как раньше: вертикальный popup по playlist_url":"menu", пункт «Отмена» внизу (если нет nocancel).


position при заданном $_PL["typeList"]="start";

$_CH["position"]=""; // - Плитка как в Стартовом меню размером 128х101px)

$_CH["position"]="html"; // - Пример элемента со своим дизайном в $_CH["template"]

$_CH["position"]="html";

$_CH["br"]=0; // Не переносить навигацию на новую строку

$_CH["title"]="Новый вид";

$_CH["description"]="Описание вида";

$_CH["logo_30x30"]="http://p.lnka.ru/icons/yapfiles.png";

$_CH["template"]='<div style="width:242px;overflow:hidden;margin:4px;text-align:center;"><img src="$logo_30x30" style="width:242px;height:171px;padding:2px 2px 0px 2px;"><br>$title<br><small>$description</small></div>';

Элементы будут выстраиваться в ряд и навигация по ним будет предполагать что они в одном ряду

$_CH["br"]

В месте где навигация должна перейти на новую строку задайте $_CH["br"]=1; При этом в before будет добавлено значение <br clear=both>

$_CH["position"]="fulleditline"; //- Поле ввода текста шириной почти на всю страницу

$_CH["position"]="hlist"; // - горизонтальная ссылка (может быть несколько на одном горизонтальном уровне)

$_CH["position"]="list"; // -обычный вид списка шириной в половину экрана и с description справа

$_CH["position"]="label"; // -невысокая строка на всю ширину экрана

$_CH["position"]="bigtile"; // - Плитка увеличенной в 2 раза высоты (128х215px)

description — прокрутка части большого текста

Добавьте в описание div с id scrolled — прокрутка кнопками PG_UP / PG_DOWN:

$_CH["description"]='MY TITLE STATIC<div id="scrolled">

PG_UP PG_DOWN

large scrolled content

.

.

.

</div>

MY FOOTER STATIC';

location

$_CH["location"]=1; // Переход c заменой текущей ссылки окна на новую (при перезапуске форкплеера будет открываться уже с этой новой ссылки)

$_CH["location"]=3; // Переход с отображением в текущем окне (при перезапуске форкплеера будет открываться старая ссылка и опять переадресовываться, необходимо если например используются устаревающие сессии)

after и before - свой html код после и перед элементом списка

$_CH["before"]="<div style='color:red;'>Текст перед элементом</div>";

$_CH["after"]="<div style='color:red;'>Текст после элемента</div>";

Локальные переменные LOCAL_IP, TORRSERVE_IP, ACE_IP

Прописываются пользователем ForkPlayer в настройках приложения.

Если не указан TORRSERVE_IP или ACE_IP — вместо них подставляется LOCAL_IP (устройство с RemoteFork).

Если не указан также LOCAL_IP — подставляется 127.0.0.1.

Примеры в magnet-ссылках

$_CH[]=["title"=>"(magnet) acestream","playlist_url"=>"http://ACE_IP:6878/server/api?method=get_media_files&magnet=".urlencode("magnet:?xt=urn:btih:642a36ec9dcb2c5ba7b08835bd04ae8738281bb1")];

$_CH[]=["title"=>"(magnet) torrserve","playlist_url"=>"http://TORRSERVE_IP:8090/torrent/play?m3u=true&link=".urlencode("magnet:?xt=urn:btih:642a36ec9dcb2c5ba7b08835bd04ae8738281bb1")];

Автовыбор torrserve или ace stream

$_CH[]=["title"=>"(magnet) через ace stream или torrserve","playlist_url"=>"magnet:?xt=urn:btih:642a36ec9dcb2c5ba7b08835bd04ae8738281bb1"];

SetTimeInterval - отправка событий клиентом через интервал и вывод сообщений

$_CH["SetTimeInterval"]=["time"=>1,"onmenu"=>"http://19onmenu","onplay"=>"http://19onplay"];

time - интервал между отправкой событий в минутах

onmenu - ссылка для отправки событий если пользователь находится в списке

в ответ по ссылке onmenu http://193.30.240.2/try/ajax/send_status_log.php?action=onmenu можно давать json 

{"message":"Hello user"}

Это уведомление будет выводится вверху форкплеера

onplay- ссылка для отправки событий если пользователь смотрит видео

Можно использовать один или два сразу тега onmenu и onplay

parser - тег загрузки другой страницы перед переходом по playlist_url или stream_url

Пример в XML 

<parser><![CDATA[http://www.youtube.com/watch?v=qZ3xj_UF4I8|js=|;]]></parser>

Пример в JSON FXML 

$_CH["parser"]="http://www.youtube.com/watch?v=qZ3xj_UF4I8|js=|;";

результат отдастся то что между js= и ;

Регулярное выражение (по маркеру .*? ) 

<parser><![CDATA[http://www.youtube.com/watch?v=qZ3xj_UF4I8|<script>.*?js=|;]]></parser>

или 

<​​​​​​​parser><![CDATA[http://www.youtube.com/watch?v=qZ3xj_UF4I8|js=|.*?js]]><​​​​​​​/parser>

преобразуется в RegExp("<script>.*?js=(.*?);","i") - результат отдастся тот что в () 

<channel><title>Test </title>
 <playlist_url><![CDATA[http://parser.co/#POSThtml=md5hash]]></playlist_url>
 <​​​​​​​parser><![CDATA[http://www.youtube.com/watch?v=qZ3xj_UF4I8]]><​​​​​​​/parser>
</channel>

#POST в playlist_url означает что все что после него будет передавать методом POST

В примере выше на адрес http://parser.co/ отправятся POST данные html=md5hash, где md5hash заменятся на полученное от parser

Допустимо в parser использовать curl запросы (доступны на андроид, частично если форк установлен в память ТВ, или через ремотефорк)

Можно перечислить порядок методов запроса парсер, например <cors>rf|android|direct|directnoheader</cors>

Сначала будет попытка запроса через remotefork (если включен), потом через андроид класс если Fork запущен на андроиде, потом прямой XHR запрос с попыткой установить заголовки, потом прямой XHR запрос без заголовков 

<channel>
 <title>Test curl and method</title>
 <cors>rf|android|direct|directnoheader</cors>
 <playlist_url><![CDATA[http://parser.co/#POSThtml=md5hash]]></playlist_url>
 <parser><![CDATA[curl "https://mysite.com/" -H "Accept-Encoding: deflate" -H "Connection: keep-alive" -H "DNT: 1" -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"]]>
 </parser>
</channel>

Или в JSON 

{
 "channels": [
   {
     "title": "Test curl and method",
     "cors": "rf|android|direct|directnoheader",
     "playlist_url": "http://parser.co/#POSThtml=md5hash",
     "parser": 'curl "https://mysite.com/" -H "Accept-Encoding: deflate" -H "Connection: keep-alive" -H "DNT: 1" -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"'
   }
 ]
}

Результат будет в $_POST['html']

Результат будет аналогично md5hash в $_GET['page']

Методом POST для видеоссылок ( stream_url )

<channel> 
 <title>stream post</title>
 <stream_url><![CDATA[http://test.ru/index.php#POSTs=md5hash]]></stream_url>
 <parser><![CDATA[https://yadi.sk/d/0BpgziSQ0VWiFg]]></parser>
</channel>

Будет идти отправка POST на http://test.ru/index.php#POSTs=md5hash в $_POST["s"]

Ответ страницы попадет в проигрыватель в виде ссылки.

Тоесть http://test.ru/index.php должен дать текст ссылки на медиафайл вида http://.../myvideo.mp4

Скачивание сторонней страницы по необходимости, страница http://parser.co/ может дать json ответ

{"parse":"http://www.youtube.com/watch?v=qZ3xj_UF4I8&gl=US&hl=en&has_verified=1&bpctr=9999999999"}

Скачанная страница шлется в параметре  $_POST['remoteparse']

Построение произвольного положения элементов на странице (c "br" вместо "coordiantion")

Задаем странице вид плиткой (start)

$_PL["typeList"]="start";

Прописываем свои стили

$_PL["css"]="

.myStyle1{

width:242px;

overflow:hidden;

margin:4px;

text-align:center;

}

.myStyle2{ width:242px; height:171px; padding:2px 2px 0px 2px; }

";

Задаем шаблон (template) каждому элементу списка

$_CH["position"]="html"; // Задает возможность использовать template

$_CH["title"]="Новый вид"; // Заголовок - подставляет в шаблоне вместо $title

$_CH["logo_30x30"]="http://p.lnka.ru/icons/yapfiles.png"; // Иконка $logo_30x30

$_CH["description"]="Описание, если нужно"; // Описание- подставляет в шаблоне вместо $description

$_CH["template"]='<div class="myStyle1"><img src="$logo_30x30" style="myStyle2"><br>$title</div>';

Перенос на новую строке при html дизайне $_CH["br"]=1;

Для правильной навигации по странице нужно знать когда у вас там новая строка. Для этого в элементе с которого нужно чтоб начиналась новая строка присваиваем 

$_CH["br"]=1;// Этот элемент разместится уже на новой строке

coordination (устаревший способ навигации)

До появления тега br навигацию по произвольному шаблону задавали координатами. Обязательно при position=html и своём template.

$_CH["coordination"]=[x,y];

Где x — позиция по горизонтали, y — по вертикали. Первый элемент: [0,0]. Элемент на новой строке: [1,0].

Горизонтальная прокрутка

Задаем nowrap только для первого (обзначается br=1) элемента блока горизонтальной прокрутки

$_CH=["br"=>1,"nowrap"=1,"title"=>"Первый элемент горизонтального блока прокрутки"];

$_CH=["title"=>"Второй элемент горизонтального блока прокрутки"];

$_CH=["title"=>"Третий элемент горизонтального блока прокрутки"];

...

$_CH=["title"=>"Последний элемент горизонтального блока прокрутки"];

$_CH=["br"=>1,"title"=>"Новый элемент с новой строки"];

Параметры GET от Fork browser

При открытии портала ForkPlayer передаёт идентификаторы в GET-запросе.

box_mac и box_user

Если пользователь вошёл в аккаунт (Меню / Настройки / Мой аккаунт), в $_GET["box_user"] передаётся email.

Пример запроса к http://nserv.host/:

http://nserv.host/?box_mac=your_mac_address&box_user=your_forkplayer_tv@email

Вывод результирующей страницы (на PHP)

<?php

// Ваш код с наполнением массивов $_PL и $_CH информацией

$_PL["channels"]=$_CH;

print json_encode($_PL);

?>

Источник — https://wiki.forkbrowser.top/w/index.php?title=FXML&oldid=2020