README_RU.md

• English documentation

Демо

• Полное демо с плагинами

Обзор

Библиотека smartbox позволяет запускать одно приложение на нескольких платформах. На данный момент поддерживаются платформы:

• Samsung SmartTv 2011+,
• Lg SmartTv,
• Philips 2012+,
• STB Infomir MAG200/250 (MAG200/250 How-to).

Для добавления своей платформы смотрите документацию по платформам

Инициализация

Smartbox имеет три зависимости:

• jQuery(1.8.1+)
• Underscore(или lodash)
• Event Emitter( Backbone или Frontbone ) для плагина плеера

Собранная версия библиотеки находится в директории /dist.

Плагины библиотеки

• Методы отдельных платформ
• Консоль Лог
• Легенда
• Навигация
  • Инициализация и методы
  • Алгоритм
  • Продвинутое использование
• Поля ввода
• Клавиатура(виртуальная)
• Голосовое управление
• Абстракция LocalStorage (хранение данных на клиентском устройстве) @todo_doc
• Плеер

Как пользоваться библиотекой

Для использования всех плагинов и функций библиотеки необходимо оборачивать код как callback SB.ready Также можно передавать коллбек в функцию SB()

    SB.ready(function(){
        // your code
    });

то же самое, что и

    SB(function(){
       // your code
    });

SB.ready будет выполнен после всех коллбеков jQuery.ready, $(function(){}), $.ready(function(){});

Методы бибилиотеки

• isInited() проверка инициализации библиотеки. Возвращает true или false

    SB.isInited();
  

• ready(func) выполняет код функции func после инициализации библиотеки

    SB.ready(function(){
        // your code
    });
  

• readyForPlatform(platform, cb) выполняет код функции func после инициализации библиотеки, если текущая платформа - platform

    SB.readyForPlatform('samsung', function(){
        // code for samsung
    });
  

также можно использовать функцию SB()

    SB('samsung', function(){
        // code for samsung
    })

Конфигурирование библиотеки

Все конфигурации библиотеки находятся в объекте SB.config

        SB.config = {}

SB.config.DUID

String: shows which method is used to get DUID for application. By default: real.

real: the method SB.Platform.getNativeDUID() is used

mac: the method device MAC-address is used, available for LG and Samsung,

random: a new DUID is generated each application starting

[other value]: will be used as DUID. For example:

SB.config.DUID="fgsfds";
SB.ready(function(){
  SB.currentPlatform.DUID;//=> "fgsfds"
});

Автотесты

Запуск автотестов Jasmine

Посты о Smartbox

• Habr: Библиотека SmartBox для Samsung, LG, Philips и других
• Habr: Создание кроссплатформенного Smart TV приложения на базе библиотеки SmartBox