Installation de TVFMediaPlayer dans Delphi¶

Bienvenue dans le guide détaillé d'installation du VisioForge Media Player SDK, et plus précisément du composant TVFMediaPlayer, dans votre environnement de développement Delphi. Ce guide couvre les installations pour les versions classiques de Delphi comme Delphi 6 et 7, ainsi que pour les versions modernes à partir de Delphi 2005, y compris les versions les plus récentes prenant en charge le développement 64 bits.

Comprendre TVFMediaPlayer¶

TVFMediaPlayer est un puissant composant VCL de VisioForge conçu pour intégrer en toute fluidité des capacités de lecture vidéo et audio dans des applications Delphi. Il simplifie des tâches telles que la lecture de divers formats multimédias, la capture d'instantanés, le contrôle de la vitesse de lecture, la gestion des flux audio, et bien plus encore. Bâti sur un moteur multimédia robuste, il offre des performances élevées et une prise en charge étendue des formats, ce qui en fait un choix polyvalent pour le développement d'applications multimédias en Delphi.

Ce guide suppose que vous disposez d'une installation fonctionnelle d'Embarcadero Delphi ou d'une version compatible plus ancienne (Borland Delphi).

Étape 1 : prérequis et téléchargement du framework¶

Avant de procéder à l'installation, assurez-vous que votre environnement de développement satisfait aux prérequis nécessaires. Vous avez principalement besoin d'une version sous licence ou d'évaluation de Delphi installée sur votre machine Windows.

Le composant TVFMediaPlayer est distribué dans le cadre du VisioForge All-in-One Media Framework. Ce framework regroupe plusieurs SDK VisioForge, fournissant une boîte à outils complète pour la gestion multimédia.

Naviguez vers la page produit : ouvrez votre navigateur web et accédez à la page produit officielle All-in-One Media Framework de VisioForge.
Sélectionnez la version Delphi : localisez la section de téléchargement spécifique à Delphi. VisioForge propose généralement des versions adaptées à différentes plateformes de développement.
Téléchargez : cliquez sur le lien de téléchargement pour obtenir le fichier exécutable d'installation (.exe). Enregistrez ce fichier dans un emplacement connu de votre ordinateur, comme votre dossier Téléchargements.

Le fichier téléchargé contient non seulement le composant TVFMediaPlayer, mais aussi d'autres bibliothèques associées, le code source (le cas échéant selon la licence), les fichiers d'exécution nécessaires et la documentation.

Étape 2 : exécuter le programme d'installation¶

Une fois le téléchargement terminé, vous devez exécuter le programme d'installation pour placer les fichiers nécessaires du SDK sur votre système.

Localisez le programme d'installation : naviguez vers le dossier où vous avez enregistré le fichier .exe téléchargé.
Exécutez en tant qu'administrateur : cliquez avec le bouton droit sur le fichier d'installation et sélectionnez « Exécuter en tant qu'administrateur ». Cela est essentiel car le programme d'installation doit enregistrer des composants et peut être amené à écrire dans des répertoires système, ce qui nécessite des privilèges élevés.
Suivez les instructions à l'écran : l'assistant d'installation vous guidera tout au long du processus. Cela implique généralement :
- D'accepter le contrat de licence.
- De choisir le répertoire d'installation (l'emplacement par défaut est généralement approprié, par exemple C:\Program Files\VisioForge\All-in-One Media Framework Delphi\). Notez ce chemin, vous en aurez besoin par la suite.
- De sélectionner les composants à installer (assurez-vous que le Media Player SDK est sélectionné).
- De confirmer l'installation.
Terminez l'installation : laissez le programme d'installation finir de copier les fichiers et d'effectuer les tâches de configuration nécessaires.

Ce processus décompresse le SDK, y compris les unités précompilées (.dcu), le paquet du composant (.dpk / .dproj) et les DLL d'exécution requises. Le composant Delphi est distribué sous forme d'unités précompilées — le code source .pas du paquet n'est pas fourni.

Étape 3 : intégration avec l'IDE Delphi¶

Après avoir exécuté le programme d'installation principal, l'étape critique suivante consiste à intégrer le composant TVFMediaPlayer dans l'IDE Delphi afin de pouvoir l'utiliser visuellement dans le concepteur de formulaires et référencer ses unités dans votre code. Le processus diffère légèrement entre les versions plus anciennes (Delphi 6/7) et les plus récentes (Delphi 2005+).

Important : pour toutes les versions de Delphi, il est recommandé d'exécuter l'IDE Delphi lui-même en tant qu'administrateur pendant le processus d'installation du paquet. Cela permet d'éviter d'éventuels problèmes de permissions lors de la compilation et de l'enregistrement du paquet du composant.

Installation dans Delphi 6 / Delphi 7¶

Ces versions plus anciennes nécessitent une configuration manuelle des chemins et l'installation des paquets.

Lancez Delphi (en tant qu'administrateur) : démarrez votre IDE Delphi 6 ou Delphi 7 avec des privilèges d'administrateur.
Ouvrez les options de l'IDE : allez dans le menu Tools et sélectionnez Environment Options.
Configurez le chemin de bibliothèque :
- Naviguez vers l'onglet Library.
- Dans le champ Library path, cliquez sur le bouton à points de suspension (...).
- Cliquez sur le bouton Add ou New (l'icône peut varier) et naviguez vers le dossier du paquet correspondant à votre version de Delphi — c'est là que se trouvent les unités précompilées .dcu, par exemple C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 7. Ajoutez ce chemin. Cela indique à Delphi où trouver les unités compilées lors de la compilation.
- Cliquez sur OK pour fermer l'éditeur de chemins.
Configurez le chemin de navigation :
- Toujours dans l'onglet Library, localisez le champ Browsing path (il peut être combiné ou distinct selon la version/mise à jour exacte de Delphi).
- Ajoutez ici également le même chemin du dossier du paquet. Cela aide l'IDE à localiser les fichiers pour des fonctionnalités telles que la complétion de code et la navigation.
- Cliquez sur OK pour enregistrer les options d'environnement.
Ouvrez le fichier de paquet :
- Allez dans le menu File et sélectionnez Open....
- Naviguez vers le sous-dossier Media Player\Packages\Delphi 7 (ou Delphi 6) dans le répertoire d'installation VisioForge (par exemple C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 7).
- Ouvrez le fichier de paquet VisioForge_Media_Player.dpk. Il s'agit d'un paquet unique — il n'y a pas de paquets d'exécution et de conception distincts.
Compilez le paquet :
- Avec VisioForge_Media_Player.dpk ouvert comme projet actif dans le gestionnaire de projets, cliquez sur le bouton Compile (ou utilisez Project -> Compile). Résolvez les éventuelles erreurs de compilation (cela est généralement inutile avec les paquets officiels).
Installez le paquet :
- Une fois la compilation réussie, cliquez sur le bouton Install dans le gestionnaire de projets.
Confirmation : vous devriez voir un message de confirmation indiquant que le(s) paquet(s) ont été installés. Le composant TVFMediaPlayer (et éventuellement d'autres du SDK) devraient désormais apparaître dans la palette de composants Delphi, probablement sous un onglet de catégorie « VisioForge » ou similaire.

Remarque sur l'architecture : Delphi 6/7 sont strictement des environnements 32 bits (x86). Vous n'installerez et n'utiliserez donc que la version 32 bits du composant TVFMediaPlayer. Le SDK peut contenir des fichiers 64 bits, mais ils ne sont pas applicables ici.

Installation dans Delphi 2005 et versions ultérieures (XE, 10.x, 11.x, 12.x)¶

Les versions modernes de Delphi offrent un processus plus rationalisé et une prise en charge robuste de plusieurs plateformes (Win32, Win64).

Lancez Delphi (en tant qu'administrateur) : démarrez votre IDE Delphi (par exemple Delphi 11 Alexandria, Delphi 12 Athens) avec des privilèges d'administrateur.
Ouvrez les options de l'IDE : allez dans Tools -> Options.
Configurez le chemin de bibliothèque :
- Dans la boîte de dialogue Options, naviguez vers Language -> Delphi -> Library (le chemin exact peut légèrement varier selon les versions).
- Sélectionnez la plateforme cible pour laquelle vous souhaitez configurer le chemin (par exemple Windows 32-bit, Windows 64-bit). Il est recommandé de configurer les deux si vous prévoyez de construire pour les deux architectures.
- Cliquez sur le bouton à points de suspension (...) en regard du champ Library path.
- Ajoutez le chemin vers le dossier du paquet correspondant à votre version de Delphi et à la plateforme, par exemple C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 13 (Win32) ou C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 13 x64 (Win64). Ce dossier contient les unités précompilées .dcu.
- Cliquez sur Add puis sur OK. Répétez pour l'autre plateforme si vous le souhaitez.
Configurez le chemin de navigation (facultatif mais recommandé) :
- Dans la même section Library, ajoutez aussi ce chemin du dossier du paquet au champ Browsing path.
- Cliquez sur OK pour enregistrer les options.
Ouvrez le fichier de paquet :
- Allez dans File -> Open Project....
- Naviguez vers le répertoire Media Player\Packages dans l'installation VisioForge. Trouvez le sous-dossier correspondant à votre version de Delphi et à la plateforme (par exemple Delphi XE11, Delphi XE12, Delphi 13, ou le dossier Delphi <version> x64 correspondant pour le 64 bits).
- Ouvrez le projet de paquet VisioForge_Media_Player.dproj (ou VisioForge_Media_Player.dpk). Il existe un paquet unique qui fournit à la fois les fonctionnalités d'exécution et de conception.
Compilez et installez :
- Dans le gestionnaire de projets, cliquez avec le bouton droit sur le projet de paquet (fichier .dpk).
- Sélectionnez Compile dans le menu contextuel.
- Une fois la compilation réussie, cliquez à nouveau avec le bouton droit et sélectionnez Install.
Confirmation : Delphi confirme l'installation, et les composants apparaissent dans la palette.

Remarque sur l'architecture : Delphi moderne prend en charge à la fois les cibles 32 bits (Win32) et 64 bits (Win64). Le SDK VisioForge fournit généralement des unités précompilées (.dcu) pour les deux. Lorsque vous compilez et installez le paquet, Delphi gère habituellement l'enregistrement pour la plateforme actuellement active. Vous pouvez changer de plateforme dans le gestionnaire de projets et reconstruire/réinstaller si nécessaire, bien que l'IDE gère souvent correctement cette association après l'installation initiale.

Étape 4 : configuration du projet¶

Après avoir installé le paquet du composant dans l'IDE, vous devez vous assurer que vos projets individuels peuvent trouver les fichiers VisioForge nécessaires à la compilation et à l'exécution.

Options du projet : ouvrez votre projet Delphi (fichier .dpr). Allez dans Project -> Options.
Chemin de bibliothèque : naviguez vers Delphi Compiler -> Search path (ou similaire selon la version).
Ajoutez le chemin du SDK : pour chaque plateforme cible (Windows 32-bit, Windows 64-bit) que vous prévoyez d'utiliser :
- Ajoutez le chemin vers le dossier du paquet correspondant à la plateforme cible, par exemple C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 13 pour Win32 et C:\Program Files\VisioForge\All-in-One Media Framework Delphi\Media Player\Packages\Delphi 13 x64 pour Win64. Cela garantit que le compilateur peut trouver les unités précompilées .dcu. Chaque version de Delphi et chaque plateforme dispose de son propre dossier Packages\Delphi <version> (et Delphi <version> x64).
Enregistrez les modifications : cliquez sur OK ou Save pour appliquer les options du projet.

Définir correctement le chemin de recherche du projet est essentiel. Si le compilateur signale qu'il ne trouve pas d'unités comme MediaPlayerMain ou MediaPlayerTypes, des chemins de recherche incorrects ou manquants en sont la cause la plus fréquente.

Étape 5 : vérification¶

Pour confirmer que l'installation a réussi :

Vérifiez la palette de composants : recherchez l'onglet « VisioForge » (ou similaire) dans la palette de composants de l'IDE Delphi. Vous devriez voir l'icône TVFMediaPlayer.
Créez une application de test :
- Créez une nouvelle application de formulaires VCL (File -> New -> VCL Forms Application - Delphi).
- Glissez-déposez le composant TVFMediaPlayer de la palette vers le formulaire principal.
- Si le composant apparaît sur le formulaire sans erreur, l'installation à la conception est probablement correcte.
- Ajoutez un bouton simple. Dans son gestionnaire d'événement OnClick, ajoutez une ligne de code basique pour interagir avec le lecteur, par exemple :
```
procedure TForm1.Button1Click(Sender: TObject);
begin
  // Assurez-vous que VFMediaPlayer1 est le nom de l'instance de votre composant
  VFMediaPlayer1.FilenameOrURL := 'C:\chemin\vers\votre\test_video.mp4'; // Remplacez par un chemin de fichier multimédia réel
  VFMediaPlayer1.Play();
end;
```
- Compilez le projet (Project -> Compile). S'il compile sans erreur « Fichier non trouvé » liée aux unités VisioForge, la configuration des chemins est probablement correcte.
- Exécutez l'application. Si elle se lance et que vous pouvez lire le fichier multimédia à l'aide du bouton, la configuration d'exécution fonctionne.

Problèmes d'installation courants et dépannage¶

Bien que le processus soit généralement simple, des problèmes ponctuels peuvent survenir :

Permissions de l'IDE : oublier d'exécuter l'IDE Delphi en tant qu'administrateur pendant l'installation du paquet peut entraîner des erreurs d'écriture dans le registre ou les dossiers système, empêchant l'enregistrement du composant. Solution : fermez Delphi, redémarrez-le en tant qu'administrateur et essayez à nouveau les étapes d'installation du paquet.
Erreurs de configuration des chemins : des chemins incorrects, que ce soit dans le Library Path de l'IDE ou dans le Search Path du projet, sont fréquents. Solution : vérifiez deux fois que les chemins pointent exactement vers le répertoire Packages\Delphi <version> (ou Delphi <version> x64) du SDK VisioForge contenant les unités .dcu. Assurez-vous que les chemins sont corrects pour la plateforme cible spécifique (Win32/Win64).
Erreurs de compilation du paquet : parfois, des conflits avec d'autres paquets installés ou des problèmes au sein même de la source du paquet peuvent provoquer des échecs de compilation. Solution : assurez-vous d'utiliser la version correcte du paquet pour votre version spécifique de Delphi. Consultez le support ou les forums VisioForge si les erreurs persistent.
Problèmes spécifiques au 64 bits : l'installation de paquets pour la plateforme 64 bits peut parfois présenter des défis particuliers, surtout dans les versions plus anciennes de Delphi qui ont introduit pour la première fois la prise en charge de Win64. Consultez l'article lié Problème d'installation de paquet Delphi 64 bits pour les problèmes connus spécifiques et les solutions de contournement.
Problèmes liés aux fichiers .otares : certaines versions de Delphi utilisent des fichiers .otares pour les ressources. Des problèmes lors de l'installation du paquet liés à ces fichiers peuvent survenir. Voir l'article lié Problème d'installation de paquet Delphi avec .otares.
DLL d'exécution manquantes : TVFMediaPlayer dépend souvent de DLL sous-jacentes (par exemple, composants FFmpeg) pour ses fonctionnalités. Bien que le programme d'installation principal les gère habituellement, assurez-vous qu'elles sont correctement placées soit dans le répertoire de sortie de votre application, soit dans un répertoire du PATH système, soit dans les dossiers System32/SysWOW64 selon le cas. Le déploiement nécessite de distribuer ces DLL nécessaires avec votre application. Consultez la documentation VisioForge pour la liste des fichiers d'exécution requis.

Étapes complémentaires et ressources¶

Avec TVFMediaPlayer installé avec succès, vous pouvez désormais explorer ses nombreuses fonctionnalités.

Explorez les propriétés et événements : utilisez l'inspecteur d'objets Delphi pour examiner les nombreuses propriétés et événements disponibles pour le composant TVFMediaPlayer.
Consultez la documentation : reportez-vous à la documentation officielle VisioForge installée avec le SDK ou disponible en ligne pour des références d'API détaillées et des exemples d'utilisation.
Exemples de code : visitez le dépôt GitHub VisioForge pour trouver des projets de démonstration et des extraits de code illustrant diverses fonctionnalités.
Demander du support : si vous rencontrez des problèmes persistants ou si vous avez des questions spécifiques non couvertes ici, contactez le support VisioForge pour obtenir de l'aide.

Veuillez contacter le support pour obtenir de l'aide sur ce tutoriel. Visitez notre page GitHub pour consulter d'autres exemples de code.