Index de l'article
Introduction
Licence
Streaming de contenu local
Streaming de Contenu Distant
Paramètres du plugin
Using playlists
Managing playlists
Using the AVR Media button
Popup window and lightbox
The system plugin
Managing Players, Rippers and Tags
Page 5 de 11 ## Paramètres du Plugin Les paramètres du plugin peuvent être réglés de deux façons : D'abord, dans l'interface d'administration du plugin, vous pouvez définir de façon globale les paramètres ce qui affecte toutes les vidéos. Deuxièmement, vous pouvez ajouter ces paramètres globaux dans chaque tag de façon individuel. Quand vous ajoutez des paramètres, les ajouter - separés par des espaces - dans la première partie du tag, comme ceci : `{`flv` width="180" height="150" autostart="true"}soiree{/flv}`. En ajoutant, utilisez toujours le nom de l'attribut en minuscule, suivit d'un signe egal, suivit d'une valeur pour l'attribut entouré de guillement de type double quote. Le tableau suivant montre les noms des paramètres supportés, leurs attributs (le nom à utiliser quand on l'ajoute au tag) et leur valeurs possible. Comme il est décrit dans le tableau des formats locaux supportés, il y a différents lecteurs utilisés pour les différents formats de fichiers. Le seul lecteur qui supporte tous les paramètres listés est le JW Media Player. Tous les autres lecteurs supportent normalement `width`, `height` et `autoplay` seulement. Le lecteur YouTube est une exception. Il supporte certains attributs spéciaux qui sont décrit dans le tableau à la fin de la page. Note : Certains attributs spéciaux ne sont pas disponibles dans l'interface d'administration et peuvent être réglés dans le tag seulement. Ces attributs sont expliqués dans les remarques.
Section globale | Nom du paramètre global | Nom de l'attribut | Valeurs
--- | --- | --- | ---
Paramètres du plugin | Classe du conteneur | avcss | N'importe quel nom de classe
Paramètres du plugin | Largeur de la vidéo principale | width | une valeur en pixel
Paramètres du plugin | Hauteur de la vidéo principale | height | une valeur en pixel
Paramètres du plugin | Largeur de la vidéo iFilm | iwidth | une valeur en pixel
Paramètres du plugin | Hauteur de la vidéo iFilm | iheight | une valeur en pixel
Paramètres du plugin | Largeur de la vidéo Metacafe | mwidth | une valeur en pixel
Paramètres du plugin | Hauteur de la vidéo Metacafe | mheight | une valeur en pixel
Paramètres du plugin | Mode d'affichage de Flash | wmode | Fenêtre, transparent ou opaque
Paramètres du plugin | Couleur d'arrière plan de Flash | bgcolor | une valeur de couleur 1)
Paramètres du plugin | Largeur du lecteur audio principal | awidth | une valeur en pixel
Paramètres du plugin | Hauteur du lecteur audio principal | aheight | une valeur en pixel
Paramètres avancés | Couleur de la barre de control | pbgcolor | une valeur de couleur 1)
Paramètres avancés | Couleur du texte de la barre de control | pfgcolor | une valeur de couleur 1)
Paramètres avancés | Couleur alternative de la barre de control | phicolor | une valeur de couleur 1)
Paramètres avancés | Couleur de l'arrière plan de la vidéo | psccolor | une valeur de couleur 1)
Paramètres avancés | Démarrage automatique | autostart | true (vrai) ou false (faux)
Paramètres avancés | Montrer la barre de control | shownav | true (vrai) ou false (faux)
Paramètres avancés | Montrer le temps | showdigits | true (vrai) ou false (faux)
Paramètres avancés | Montrer les icones | showicons | true (vrai) ou false (faux)
Paramètres avancés | Montrer le bouton stop | showstop | true (vrai) ou false (faux)
Paramètres avancés | Montrer le bouton de téléchargement | showdownload | true (vrai) ou false (faux) 7)
Paramètres avancés | Montrer le bouton de plein écran | usefullscreen | true (vrai) ou false (faux)
Paramètres avancés | Activer le javascript | enablejs | true (vrai) ou false (faux) 5)
Paramètres avancés | Logo | logo | URL/chemin relatif 2)
Paramètres avancés | Mode d'affichage de la vidéo | screenmode | un mode 3)
Paramètres avancés | Taille de la playlist | plsize | une valeur en pixel 3)
Paramètres avancés | Etirer le contenu | stretch | 0, 1, 2 or 3 4)
Paramètres avancés | Minimum de la version de Flash | flashver | Trois chiffres, separés par des points 10)
Paramètres avancés | Montrer l'equalizer | showeq | true (vrai) ou false (faux)
Paramètres avancés | Montrer le barre de recherche | searchbar | true (vrai) ou false (faux)
Paramètres avancés | Chercher le fournisseur | searchlink | URL 12)
Paramètres avancés | Contenu alternatif | alt | n'importe quelle page HTML valide 13)
- | - | cfg | URL 6)
- | - | displaywidth | une valeur en pixel 3)
- | - | displayheight | une valeur en pixel 3)
- | - | divid | any ID value 5)
- | - | link | URL 7)
- | - | linkfromdisplay | true (vrai) ou false (faux) 7)
- | - | linktarget | un nom de fenêtre (ex: _blank) 7)
- | - | plthumbs | true (vrai) ou false (faux) 8)
- | - | type | Un type de fichier 9)
- | - | repeat | false (faux), true (vrai) ou list (La liste) 8)
- | - | shuffle | true (vrai) ou false (faux) 8)
- | - | autoscroll | true (vrai) ou false (faux) 8)
- | - | recurl | URL 11)
- | - | img | URL 14)
- | - | volume | int 15)
- | - | menu | true (vrai) ou false (faux) 16)
- | - | popup | true (vrai) ou false (faux) 17)
Remarques : 1. Les valeurs de couleur peuvent être specifiées dans n'importe quel format suivant et sont convertis dans le format correct automatiquement : A 6-digit hexadecimal value, preceeded by a hash sign (e.g.: `#223344` like ordinary HTML syntax) A 3-digit hexadecimal value, preceeded by a hash sign (e.g.: `#234` like CSS short syntax) 3 decimal values following the word rgb in parenthesis (e.g.: `rgb(99,140,235)` - like CSS rgb syntax) A 1-6-digit hexadecimal value, preceeded by 0x (e.g.: `0x2345` like in JavaScript) One of the 16 standardized color names as specified in HTML 4.0.1 (e.g.: `red`) 2. Logo images can be specified either by their absolute URL (e.g.: http://host/logo.png) or - if locally stored on the same server - by their local path (e.g.: /images/stories/logo2.png). The logo should be png (preferred) or gif in order to support transparency. The logo is always positioned in the upper right corner of the video screen. If you like a different position you can work around this limitation by creating a larger image where most of the image is transparent. 3. The parameter screenmode is kind of special. It is not an actual parameter for JW mediaplayer but a shortcut which affects how the player's parameters displaywidth and displayheight (those specify the size of the player's video screen) are calculated by the plugin. The following modes are available:
| Mode | Description
--- | --- | ---
| default | This mode results in the standard display where the player's control bar is located below the screen. Since the control bar has a height of 20 pixels, the available screen size is width × height - 20.
| coverlay | In this mode, displaywidth and displayheight are set equally to width and height. This results in the control bar being shown transparently inside the screen area. Furthermore, the control bar fades out, if the mouse leaves the screen area and reappears if the mouse enters the screen area. The available screen size in this mode is width × height.
| plbottom | This mode is intended to display a playlist at the bottom below the control bar. The height of this scrollable window is taken from the parameter plsize. The available screen size in this mode is width × height - 20 - plsize.
| plright | Like plbottom, except the playlist is to be displayed to the right of the screen. The width of the scrollable window is taken from the parameter plsize. The available screen size in this mode is width - plsize × height - 20.
| floatcplright | A combination of coverlay and plright. In this mode, the available screen size is width - plsize × height.
Please note: When overriding displaywidth or displayheight within the tag, then the whole automatic calculation described above is disabled. 4. The stretch mode defines how to stretch movies to make them fit the display size. 1 will stretch them proportionally to fill the display, 0 will stretch them to fit. 2 will stretch them disproportionally to fit both height and width. 3 will show all items in their original dimensions. 5. If enabling scripting, the player can be controlled with JavaScript. To do this (and to distinguish multiple players in a page) it has to be addressed by it's ID. For easy scripting, this ID (which otherwise would be assigned automatically by the plugin) can be set manually by using the attribute divid. The resulting ID of the flash object to be used from within JavaScript is the specified value, prefixed by p_. 6. If many parameters have to be specified, you end up with quite lenghly tags. Alternatively, you can put all those parameters in a config file and then simply reference that. The URL, specified in the cfg attribute should point to a configuration XML file. The variable names in that file might differ from the attributes listed above. See the JW Media Player documentation for a reference. An example file can be found here. 7. The URL, specified in the link attribute is normally used for providing a download of the media or related information. This URL is invoked, when the player's download button is activated. Additionally, if the attribute linkfromdisplay is set to true, a click in the players display invokes that URL instead of toggling play/pause. The attribute linktarget (default: _blank) specifies the window in which this URL will be shown. 8. If plthumbs is set to true and a playlist is provided which provides image tags in its entries, those images are displayed as thumbnails in the playlist. If autoscroll is set to true, the playlist is scrolling automatically via mouse movement instead of using a scrollbar. The attribute repeat specifies how to proceed when a media stream is finished: false means stop the player, true means repeat the stream from beginning and list means start playing the next item in the playlist. In this context, the next item to be played is selected depending on the parameter shuffle (default: true). If this is set to false, the playlist is iterated sequentially. Using playlists is explained further down. 9. If using the remote variant of a media tag, you can reference any media file, even with a different extension or non extension at all. If this is the case, JW Media Player might not recognize the file type correctly. With this attribute you can forcibly set the media type to one of the supported types. 10. This attribute allows you to set the minimum Flash version, required to use the builtin JW Media Player. The player requires at least Flash version 7, however when running under that version, the features "display of GIF/PNG images", "smoothing of scaled images/video", VP6 and H264 encoded video, javascripting and the digits in the controlbar are not functional. Furthermore, for full screen display, at least Flash version 9.0.28 is required and for playing H264 encoded videos, at least Flash version 9.0.98. For full functionality, it is therefore strongly recommended, to specify at least version 9.0.28 (if using the fullscreen feature) or version 8 (without using fullscreen). 11. This attribute provides an URL for a recommendations XML file. A recommendations XML file contains titles, thumbnails and URLs for recommended Items, related to the currently playing video. It's content is shown after the video has finished playing (Similar like on YouTube). A sample recommendations XML file can be found here. 12. The URL provided here defines an alternate search provider which is used, when a user uses the search function of the search bar. The text typed by the user is appended to this URL. Example: If the URL is `http://youtube.com/results?search_query=` and the user searches for `computer`, then the resulting query is `http://youtube.com/results?search_query=computer`. 13. By default, the plugin provides two different warnings if the content can not be displayed: The first warning is displayed, if JavaScript is not available. Another warning is displayed, when JavaScript is working, but the flash plugin is either not available or it's version is below the value of the parameter flashver. With this parameter, the second warning can be replaced by custom content. If custom content is provided, the first warning will be disabled completely. The custom content must not contain any single quote or closing curly brace. To display those characters, they have to be encoded using html entities. The default warnings look like this: Typical appearance of the default JavaScript warning (uses localized text): JavaScript is disabled! To display this content, you need a JavaScript capable browser. Typical appearance of the default Flash warning (uses localized text): Adobe Flash Player not installed or older than x.x.x! 14. This attribute allows to specify a preview (thumbnail) image which is shown whenever the player is stopped. If a relative path is specified (i.e. the value does not start with a slash or `http://` or `https://`), then it is automatically prefixed by the default image directory (usually `images/stories`). 15. The initial volume. Unit is percent, which implies a valid range of 0 .. 100. 16. This attribute can be used to manipulate the context menu of the player. For flash based players, setting this to false restricts the menu to the basic entries. For the DivX player, this disables the menu completely. 17. When this attribute is set to true, then the resulting player will be invisible and prepared to be displayed in a popup window or lightbox by using the avrpopup special tag. ## Special parameters of the YouTube player When using the tag `{`youtube`}`, the YouTube player supports the following additional attributes (All boolean attributes have a default value of false):
Global section | Global parameter name | Attribute name | YouTube API Name | Values
--- | --- | --- | --- | ---
Paramètres avancés | Autostart | autostart | autoplay | true (vrai) ou false (faux)
Paramètres avancés | Controls color | pbgcolor | color1 | une valeur de couleur
Paramètres avancés | Controls highlight color | phicolor | color2 | une valeur de couleur
- | - | ytborder | border | true (vrai) ou false (faux)
- | - | ytegm | egm | true (vrai) ou false (faux)
- | - | ytloop | loop | true (vrai) ou false (faux)
- | - | ytrel | rel | true (vrai) ou false (faux)
More information about the meaning of those attributes can be found in the YouTube API specification here. << Préc - Suivant >>
Mis à jour ( Samedi, 05 Juillet 2008 03:45 )