Création d'un menu contextuel personnalisé par clic droit

Cette leçon pratique vous guide dans la configuration du fichier manifest.json et l'implémentation de la méthode registerCommand pour créer des outils accessibles d'un simple clic droit, tout en respectant l'architecture asynchrone et sécurisée du SDK d'extensions d'Ableton.

L'intégration native dans l'interface d'Ableton Live

L'un des atouts majeurs du SDK d'extensions d'Ableton Live 12.4.5 est sa capacité à s'intégrer de manière transparente dans l'interface utilisateur. Plutôt que de forcer l'utilisateur à ouvrir une fenêtre externe, vous pouvez greffer vos fonctionnalités directement sur le menu contextuel du clic droit.

Dans cette leçon pratique, nous allons étudier comment déclarer des commandes contextuelles, cibler des objets précis (clips, pistes) et sécuriser l'exécution de vos scripts selon le contexte de sélection de l'utilisateur.

Fondamental

Arguments des commandes : Handles vs ArrangementSelection

Les arguments transmis au callback de votre commande enregistrée dépendent de la manière dont la commande a été déclenchée dans l'interface utilisateur d'Ableton Live :

Handles d'objets (Object Handles) : La plupart des menus contextuels (par exemple, un clic droit sur un AudioClip ou une Track) transmettent un unique Handle (référence) comme premier argument. Vous utilisez alors context.getObjectFromHandle(handle, Class) pour récupérer l'objet typé.
Sélection de l'Arrangement (Arrangement Selection) : Si l'utilisateur effectue un clic droit sur une sélection temporelle dans la vue Arrangement, le SDK transmet un objet de type ArrangementSelection. Cet objet contient la plage temporelle sélectionnée ainsi que la liste des pistes concernées.