BarrageRenderer est une bibliothèque open source iOS qui permet d'afficher des commentaires flottants (danmaku) en temps réel sur des lecteurs vidéo. Elle prend en charge plusieurs types de commentaires (passage, suspension) et offre des options de personnalisation avancées (police, couleur, vitesse). Ce tutoriel vous guide pour intégrer BarrageRenderer dans votre projet.

Installation

Assurez-vous d'avoir installé CocoaPods. Créez un fichier Podfile à la racine de votre projet et ajoutez les lignes suivantes :

platform :ios, '9.0'
use_frameworks!

target 'VotreNomDeCible' do
  pod 'BarrageRenderer', '~> 1.9.1'
end

Exécutez ensuite la commande :

pod install

Utilisation de base

Importez le module dans votre contrôleur de vue et créez une instance de BarrageRenderer :

#import <BarrageRenderer/BarrageRenderer.h>

@interface ViewController ()
@property (nonatomic, strong) BarrageRenderer *moteurDanmaku;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    // Initialisation du moteur de rendu
    self.moteurDanmaku = [[BarrageRenderer alloc] init];
    
    // Ajout de la vue du moteur à la vue principale
    [self.view addSubview:self.moteurDanmaku.view];
    
    // Démarrage de l'affichage des commentaires
    [self.moteurDanmaku start];
    
    // Envoi d'un premier commentaire
    BarrageDescriptor *descripteur = [[BarrageDescriptor alloc] init];
    descripteur.spriteName = @"BarrageWalkTextSprite";
    [descripteur.params setObject:@"Bonjour, Danmaku !" forKey:@"text"];
    descripteur.params[@"textColor"] = UIColor.orangeColor;
    descripteur.params[@"font"] = [UIFont boldSystemFontOfSize:18];
    
    [self.moteurDanmaku receive:descripteur];
}

@end

Gestion du flux

Pour contrôler l'affichage, utilisez les méthodes suivantes :

// Arrêt complet
[self.moteurDanmaku stop];

// Pause temporaire
[self.moteurDanmaku pause];

// Reprise
[self.moteurDanmaku resume];

Cas d'usage et bonnes pratiques

Commentaires en direct

Dans une application de streaming en direct, les commentaires renforcent l'interaction. BarrageRenderer permet d'ajouter des messages en temps réel et de modifier leur apparence selon le contenu diffusé.

Commentaires différés (VOD)

Pour une vidéo à la demande, vous pouvez synchorniser les commentaires avec la timeline de la vidéo grâce à la fonction de délai intégrée.

Personnalisation avancée

Modifiez la couleur, la police ou la vitesse des commantaires :

descripteur.params[@"textColor"] = [UIColor magentaColor];
descripteur.params[@"font"] = [UIFont fontWithName:@"HelveticaNeue-Bold" size:20];
descripteur.params[@"speed"] = @(150); // pixels par seconde

Projets utilisant BarrageRenderer

La bibliothèque est notamment employée dans l'application iOS de Bilibili, une plateforme chinoise de vidéos avec commentaires flottants. D'autres lecteurs vidéo l'intègrent pour offrir une expérience enteractive similaire.