Produits en direct et liens pour les spectateurs

1. Ajouter un produit ou un lien de soutien

Ouvrez Monetization > Products & support links > Set up products and links. Collez un lien HTTPS public et choisissez Charger les détails depuis le lien (Load details from link). L'importation rapide prend en charge les pages publiques Gumroad, itch.io, Ko-fi, Buy Me a Coffee et Fourthwall. Les domaines personnalisés, redirections, pages privées et pages sans métadonnées publiques peuvent nécessiter une saisie manuelle. Les options existantes d'importation API Shopify et Fourthwall restent disponibles.

Vérifiez le titre, l'image, le prix, la devise et la finalité. L'importation rapide laisse volontairement le prix vide. Choisissez Ajouter un produit ou un lien, activez Produits et liens de soutien, puis Enregistrer la configuration. Aucun compte marchand n'est nécessaire pour les cartes manuelles.

Shop, Gift, Support et Join décrivent la finalité du lien. Ils ne modifient pas la classification des événements de paiement ultérieurs. Les cartes sont des instantanés enregistrés ; la page de paiement fait autorité pour le stock et les prix.

2. Contrôler ce qui apparaît

Ajoutez l'URL existante de l'incrustation Products & support links à OBS. Utilisez Showcase ou Support card pour les promotions, ou Both pour inclure les alertes d'activité.

• Afficher maintenant (Show now) sur une ligne enregistrée épingle ce produit et remplace la programmation périodique des cartes.
• Produit suivant (Next product) épingle le produit enregistré suivant.
• Masquer les produits (Hide products) masque les cartes promotionnelles. Les alertes d'achat et de cadeau continuent.
• Reprendre la programmation (Resume schedule) rétablit les paramètres enregistrés de premier produit ou de rotation.

Définissez Show/hide seconds avant d'utiliser une commande. Zéro reste actif jusqu'à modification ; 1 à 3600 rétablit la programmation enregistrée après ce nombre de secondes. Les remplacements en direct sont réinitialisés au redémarrage de SSN. Les lignes non enregistrées sont marquées et leurs boutons Show now restent désactivés jusqu'à Save setup. L'état nomme le produit sélectionné et affiche les secondes restantes ; il n'affirme pas qu'OBS est en direct ni que cette source est visible. Les commandes identifient un produit par son URL enregistrée exacte ; le déplacer dans la liste ne perturbe donc pas une automatisation.

3. Publier un lien unique pour les spectateurs

Ouvrez Display options > Public viewer page et choisissez Publier les liens enregistrés (Publish saved links). Cela publie explicitement tous les liens de produits/soutien enregistrés, y compris les titres, images, prix et finalités. Partagez Copier le lien public (Copy viewer link) avec vos spectateurs. Les codes QR des produits utilisent désormais cette page stable, pour qu'un spectateur puisse encore trouver un produit après la rotation de l'incrustation.

Les modifications enregistrées et les commandes en direct mettent à jour la même URL. La page publique vérifie les mises à jour toutes les 15 secondes et indique le produit mis en avant. Les autres liens restent accessibles lorsque les cartes promotionnelles sont masquées. Le dernier catalogue publié reste accessible lorsque SSN est hors ligne ; la date d'enregistrement est affichée et la mise en avant désigne la dernière sélection ou rotation enregistrée, pas une preuve que le créateur est en direct.

Dépublier (Unpublish) supprime la page ; les codes QR des produits reviennent aux liens individuels des produits. Les pages publiques ouvertes s'effacent lors de leur prochaine vérification réussie. Les URL déjà partagées cessent de charger jusqu'à une nouvelle publication. Republier depuis le même appareil rétablit la même URL. Conservez le profil de l'appareil SSN : sa clé privée de publication est nécessaire pour modifier ou retirer la page.

Si l'API est indisponible, les commandes locales fonctionnent toujours. Les mises à jour échouées laissent la dernière page publiée visible et sont retentées tant que SSN est ouvert. La fenêtre signale l'échec. La publication nécessite le déploiement du service facultatif de boutique publique ; aucun compte de boutique ou de paiement n'est concerné.

Event Flow et commandes à distance

Dans Event Flow, ajoutez l'action Produits et soutien du groupe d'actions d'incrustation. Sélectionnez Show, Next, Hide ou Resume ; définissez éventuellement l'URL exacte du produit enregistré et la durée en secondes. Utilisez un déclencheur existant adapté, par exemple votre propre commande de modérateur, plutôt que de permettre à chaque message du chat de changer les produits.

Dans le plugin Stream Deck, ajoutez des touches Preset Command depuis Produits et soutien (Products & support): Show product, Next product, Hide products et Resume products. Show inclut un sélecteur de produit enregistré ; choisissez Refresh products and state pour charger la liste. Une sélection enregistrée indisponible reste visible au lieu de changer silencieusement. Vous pouvez toujours coller l'URL publique du produit ou la laisser vide pour le produit actuel/premier. Next et Hide acceptent une durée facultative en secondes. Les touches attendent la confirmation par SSN du changement local, indépendamment des mises à jour de la page publique. Ajoutez la touche facultative Product State pour un retour sur la sélection, le masquage et la programmation, actualisé toutes les cinq secondes lorsque la touche est visible. L'inspecteur et SSN montrent le nom complet du produit ; la petite touche d'état tronque les noms longs. Utilisez la connexion P2P ou WebSocket existante.

L'API distante existante de session authentifiée accepte la même commande :

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

Les commandes sont show, next, hide et resume. Omettez l'URL pour afficher le produit actuel/premier. Les commandes d'hôte doivent être activées. Ne partagez jamais d'URL privée de session/contrôle avec les spectateurs ; utilisez le lien public publié.

Ces actions diffusent uniquement l'état existant monetization_update état d'affichage. Elles ne créent ni dons, ni achats, ni publications dans le chat, ni déclencheurs de paiement Event Flow. Le mécanisme existant hasDonation le comportement reste inchangé.

Savoir quand une commande est terminée

L'action Products & Support attend la réponse de SSN avant de poursuivre le flux. Sur les données d'événements ordinaires, meta.commerceControlResult contient success et soit le résultat commerce état de contrôle ou un error. Un échec arrête les actions suivantes de cette chaîne ; l'achat ou le pourboire d'origine reste disponible pour les autres flux et incrustations. L'état confirme la sélection, le masquage ou la programmation de SSN ; la visibilité dans OBS reste distincte.

Si aucune réponse n'arrive sous huit secondes, l'action signale une expiration. La commande peut tout de même avoir été appliquée : vérifiez l'état dans la fenêtre ou le Dock avant de retenter Next. Les clients distants externes doivent utiliser le protocole existant de requête/réponse et vérifier le résultat renvoyé au lieu de considérer l'envoi d'une commande comme une réussite.

Les autres effets ont leur propre retour. Print Thermal Label signale meta.thermalPrintResult; l'envoi réussi d'une tâche ne confirme pas l'impression papier. Une action Webhook synchrone peut renvoyer le statut et la réponse HTTP et bloquer en cas d'échec. Ce sont des résultats d'actions, pas de nouveaux événements de paiement. Consultez la référence des événements pour le contrat des résultats de commande.