Documentation

F REEBOX TEAM Rev. 1.0 (5 mars 2008) c Free 2008

Table des matires

1 Introduction 2 Pr-requis techniques 2.1 Langage HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 Hbergement et connectivit du Tlsite . . . . . . . . . . . . . . . . 2.3 Restriction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Comment ajouter un Tlsite 3.1 Console de gestion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2 Ajout dun Tlsite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.3 Gestion des Tlsites . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4 4 4 5 6 6 8 9

4 Intgration de contenus de TVP ERSO F REEBOX aux Tlsites 11 4.1 Prsentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.2 Exemples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Table des matires

I NTRODUCTION
Le service des Tlsites de Free permet aux abonns dgroups et quips dune Freebox HD (et ultrieurement ceux munis dune Freebox v4) de :

Concevoir un site web prvu pour tre visualis via une Freebox. Consulter directement partir de leur tlviseur les sites cres et mis disposition par les autres Freenautes. Intgrer des vidos issues du Service TV P ERSO F REEBOX dans des sites, an de (par exemple) les mettre en valeur.

Introduction

P R - REQUIS

TECHNIQUES

2.1 Langage HTML

Pour pouvoir tre afch convenablement par la Freebox, un tlsite doit respecter les spcicits du HTML 3.2 Freebox. De la documentation sur ce langage est disponible ladresse suivante : http://wiki.freeplayer.org/index. php?title=HTML_Freebox.

Nous vous conseillons fortement de lire cette documentation, en particulier pour prendre connaissance des limitations du navigateur interne la Freebox ainsi que les extensions par rapport au standard ofciel du HTML 3.2.

Veuillez galement noter que le navigateur de la Freebox ne supporte que la version 1.0 du protocole HTTP.

2.2 Hbergement et connectivit du Tlsite

Free nassure pas lhebergement de vos Tlsites. Vous pouvez utiliser le prestataire technique de votre choix, la seule limitation tant la suivante : lintgralit du Tlsite (pages HTML, images, . . .) doit tre accessible en IPv6. Tout lment dune page accessible uniquement en IPv4 ne pourra pas tre afche par Pr-requis techniques
4

la Freebox. Lors de la dclaration du Tlsite ou dans les liens de vos pages, vous pouvez votre convenance utiliser soit un nom de domaine (ex : http://www. free.fr)1 , soit une adresse IPv6 (ex : http://[2a01:5d8:e200::1]).

2.3 Restriction
Il nest pas autoris de diffuser des chiers multimdias (vidos ou sons) par lintermdiaire dun Tlsite, que ca soit par un lien direct (ex : href vers un chier mp3) ou par chargement en fond de page (ex : attribut background). La seule faon de diffuser de la vido via un Tlsite est dutiliser le systme dintgration des contenus de TVP ERSO F REEBOX (cf. page 11). Toutefois, il existe une unique tolrance concernant les vidos xes de fond dcran de type mp2v (Elementary Stream MPEG-2 Video sans multiplexage) dune taille raisonnable (infrieure 1 Mo).

A condition bien sr quun enregistrement DNS de type AAAA correspondant existe.

Pr-requis techniques

C OMMENT

AJOUTER UN

T LSITE

3.1 Console de gestion

La premire tape pour pouvoir ajouter votre Tlsite est de se rendre sur la console de gestion de votre abonnement, prsente sur http://subscribe. free.fr/login/. Une fois connect, cliquez sur le lien Gestion de mes Tlsites prsent dans la rubrique Fonctionnalits optionnelles (en bas droite de la page). Lors de votre premire visite, vous trouverez la page suivante vous invitant choisir un nom dutilisateur sur le service des Tlsites :

Le pseudonyme choisi doit comporter entre 3 et 20 caractres, et ne peut tre compos que de lettres, de chiffres et du caractre tiret (-).

Comment ajouter un Tlsite

Une fois votre pseudonyme choisi, la page principale du site de gestion des Tlsites safchera :

Vous y retrouverez le pseudonyme que vous avez choisi, le nombre de Tlsites que vous appartenant et le nombre total de Tlsites que vous pouvez dclarer. Le lien Ajout dun Tlsite vous mnera linterface permettant de dclarer un nouveau Tlsite (cf page suivante). Ce lien nest pas disponible si votre quota de Tlsites est atteint. Le lien Gestion de mes Tlsites vous permet de modier les informations relatives un Tlsite dj dclar, ou de supprimer certains de vos Tlsites.

Comment ajouter un Tlsite

3.2 Ajout dun Tlsite

Il est conseill de remplir correctement les champs Titre et Description. Le premier sera directement visible dans linterface du service, le second servant au moteur de recherche interne. LURL du Tlsite ne sera pas indique sur linterface tlvisuelle et ne sera jamais mise disposition des Freenautes consultant le service. La case Tlsite accessible vous permet de tester lafchage de votre site sur votre tlviseur via la Freebox sans pour autant le rendre visible par tout le monde. Si la case est dcoche, ce Tlsite ne fera pas partie du catalogue du service, mais vous pourrez y accder via la rubrique Mes Tlsites sur linterface tlvisuelle. Une fois vos tests effectus, il vous suft de cocher cette case et de valider pour rendre votre Tlsite immdiatement accessible lensemble des Freenautes. Attention, un Tlsite dclar comme non accessible compte quand mme dans votre quota global. Comment ajouter un Tlsite
8

Cependant, lorsque vous dcidez de publier lun de vos Tlsites, un test daccessibilit est effectu. Sil choue, le Tlsite restera en dehors du catalogue et vous en serez inform via la page de dtails.

3.3 Gestion des Tlsites

Sur cette page, vous retrouverez la liste des Tlsites vous appartenant. Si lun de vos Tlsites na pas pu tre joint par notre systme de vrication, vous en serez prvenu par un message.

Le lien Modier vous mne sur une page identique celle dajout dun Tlsite, mais dont les champs sont pr-remplis avec les informations dj saisies.

Comment ajouter un Tlsite

 Le lien Supprimer enlve dnitivement du service le Tlsite en question. Toute suppression est dnitive. Si votre quota de Tlsites est dpass, vous pourrez en crer de nouveaux uniquement aprs en avoir supprim.

Comment ajouter un Tlsite

10

I NTGRATION DE CONTENUS DE TVP ERSO F REEBOX AUX T LSITES

4.1 Prsentation
Si vous avez mis disposition du contenu sur TV P ERSO F REEBOX et que vous souhaitez le mettre en valeur autrement que par linterface classique du service, nous vous proposons la possibilit dintgrer vos vidos vos Tlsites. Pour cela, nous mettons votre disposition 3 balises Meta1 : tvperso_stored_base : Pour afcher la vignette correspondant votre vido enregistre en diffr. tvperso_live_base : Pour afcher la vignette correspondant votre vido diffuse en live. tvperso_stream_base : Pour pouvoir crer un lien lanant la lecture de la vido. Si votre vido est classe comme prive, seules les personnes que vous aurez autorises via un groupe de partage pourront consulter la vido via un Tlsite.

cf page 4

Intgration de contenus de TVP ERSO F REEBOX aux Tlsites

11

4.2 Exemples
En ce qui concerne les vignettes, quatre versions sont disponibles : grande (240x180), petite (96x72), au format PNG et au format GIF. Pour utiliser la grande vignette, il faut ajouter -big entre lidentiant de la vido et lextension du chier. Supposons que votre vido ait un identiant qui soit 17871, voici des exemples de code HTML intgrer dans vos pages pour pouvoir bncier de cette fonctionnalit :

<!-- vignette de la video differee 17871 en petit format et en png --> <img src=<var name=tvperso_stored_base>/17871.png>

<!-- vignette de la video live 17871 en grand format et en gif --> <img src=<var name=tvperso_live_base>/17871-big.gif>

<!-- pour lancer la lecture dune video comme fond dune page --> <body background=<var name=tvperso_stream_base>/17871>>

Intgration de contenus de TVP ERSO F REEBOX aux Tlsites

12