Audience :Cet article s'adresse aux responsables engineering, aux responsables de programmes OEM et aux architectes de plateformes EdTech qui doivent intégrer des événements de stylet de lecture dans une application parentale, un LMS scolaire ou une suite d'apprentissage d'éditeur. Les lecteurs secondaires incluent les intégrateurs de firmware qui évaluent le compromis entre SDK et REST brut.
La plupart des stylets de lecture sur le marché sont encore fournis en tant qu'appareils fermés. Vous pointez, vous appuyez, l'audio joue, fin de l'histoire. Pour un programme OEM ou une plateforme d'éditeur qui doit capturer les événements de lecture, synchroniser les progrès et déclencher du contenu adaptatif, ce n'est pas suffisant. Vous avez besoin d'un stylet de lecture avec un vrai SDK et une API REST documentée. L'équipe engineering du Smart Reading Pen a publié 86 versions de firmware depuis 2023, et trois de nos modèles actuels — P2, T2 et Y6 — sont positionnés spécifiquement pour les intégrateurs. Ce guide compare la surface du SDK, les points de terminaison de l'API et le flux de travail d'intégration qui fait passer un partenaire d'un échantillon à une production OEM de 5 000 unités.
1. Pourquoi la couverture SDK et API est importante pour les programmes OEM
Un programme OEM est plus qu'un stylet en marque blanche. C'est un contrat qui dit : chaque événement émis par le stylet arrivera dans l'entrepôt analytique de notre partenaire. Si le firmware est fermé et que le cloud est verrouillé, le partenaire dépend de nous pour publier des fonctionnalités. Si nous livrons un SDK et une API REST, le partenaire possède l'intégration et peut publier selon son propre calendrier.
Dans nos données de production 2023–2026, les 11 programmes OEM qui ont consommé le SDK ont publié en moyenne 4,7 versions de fonctionnalités par an contre 1,3 que nous avons publiées sur les références à firmware fermé. Les partenaires OEM ont également conservé leurs clients à un taux de 92 % contre 71 % pour les références à firmware fermé sur la même période de 24 mois. La couverture SDK stimule directement la rétention.
Conseil acheteur :Demandez à chaque usine candidate si elle acceptera de signer un NDA, de vous fournir un package SDK d'échantillon et de laisser vos ingénieurs effectuer un test de 5 jours avant toute signature de bon de commande. Si la réponse est « nous discuterons après le bon de commande », passez votre chemin.
2. Les 11 modèles de stylets de lecture et leur position sur l'échelle d'intégration
Les 11 modèles de notre gamme 2026 exposent tous une forme de données d'événements, mais seuls trois d'entre eux disposent de la surface complète SDK + REST dont les intégrateurs OEM ont besoin. Les huit autres sont conçus pour des cas d'usage en vente au détail ou en bundle scolaire où un firmware fermé est acceptable.
| Modèle | Firmware | Batterie | Connectivité | Niveau SDK | Idéal pour |
|---|---|---|---|---|---|
| B1 | 2.4.7 | 700 mAh / 5,0 h | USB-C uniquement | Aucun | Vente au détail, entrée sous 10 $ |
| B2 | 2.4.7 | 800 mAh / 5,5 h | USB-C uniquement | Aucun | Vente au détail, batterie légèrement plus grande |
| F8 | 3.1.2 | 600 mAh / 4,5 h | USB-C, prise jack 3,5 mm | Journal uniquement | Bundles scolaires, utilisation hors ligne |
| K7 | 1.9.5 | 800 mAh Li-ion 14500 / 6,0 h | USB-C, BT 4.2 | Journal uniquement | Bundles de démarrage K–3 |
| KF1 | 1.9.5 | 800 mAh Li-ion 14500 / 6,0 h | USB-C, BT 5.0 | Journal uniquement | Bundles de démarrage K–3 avec BT |
| L5 | 4.2.0 | 1 200 mAh / 8,5 h | USB-C, BT 5.0, Wi-Fi 2,4 GHz | SDK partiel | Vente au détail premium, hooks d'événements partiels |
| P2 | 2.0.3 | 500 mAh / 4,0 h | USB-C, BT 5.0 | SDK complet + REST | OEM EdTech, stylet léger |
| Q6 | 3.3.1 | 900 mAh / 6,5 h | USB-C, BT 5.0 | Journalisation uniquement | Distribution grand public de milieu de gamme |
| Q8 | 3.3.1 | 1 000 mAh / 7,0 h | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz | SDK partiel | Distribution premium, application parentale |
| T2 | 2.6.4 | 2 500 mAh Li-ion 18650 / 14 h | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz | Full SDK + REST | Flotte scolaire, OEM |
| Y6 | 2.6.4 | 2 000 mAh / 11 h | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz, LTE Cat-1 en option | Full SDK + REST + Webhook | OEM flagship, école + domicile |
Le schéma est clair. À mesure que vous montez dans la gamme, la surface SDK, la connectivité et la batterie s'élargissent toutes. P2 est le stylo Full-SDK le plus léger à 38 g, T2 offre la plus longue autonomie, et Y6 est le seul avec LTE en option pour les déploiements de flotte où le Wi-Fi est peu fiable.
3. P2, T2, Y6 : Les trois modèles Full-SDK
Quand les intégrateurs nous demandent le « meilleur stylo de lecture avec intégration SDK et API », nous les orientons vers P2, T2 et Y6. Chacun couvre un cas d'usage distinct.
3.1 P2 — Le stylo OEM léger
P2 exécute le firmware 2.0.3 sur un MCU dual-core avec 4 Mo de flash. Le SDK expose 18 fonctions : 6 pour les événements de scan OID, 4 pour la lecture audio, 4 pour l'état de l'appareil (batterie, bouton, veille), 2 pour la session utilisateur et 2 pour le firmware OTA. La batterie est de 500 mAh avec une autonomie de 4,0 h, la plus basse de la gamme mais qui maintient le poids à 38 g. P2 est la bonne solution pour un éditeur qui intègre le stylo dans une série de livres illustrés et nécessite la capture OID plus la lecture audio câblée dans l'application parentale.
3.2 T2 — Le cheval de bataille pour flotte scolaire
T2 exécute le firmware 2.6.4 sur un Cortex-A53 quad-core avec 16 Go de flash. Le SDK expose 32 fonctions : 6 pour OID, 4 pour l'audio, 6 pour la session Wi-Fi, 4 pour l'état, 4 pour l'utilisateur et la classe, 4 pour OTA et 4 pour les diagnostics. La batterie est de 2 500 mAh Li-ion 18650 avec une autonomie de 14 h, suffisante pour une journée scolaire complète K-8. T2 est le choix standard pour une flotte scolaire de 12 000 unités où l'intégration doit survivre à 18 mois d'utilisation quotidienne.
3.3 Y6 — Le stylo OEM flagship avec streaming Webhook
Y6 exécute le firmware 2.6.4 sur la même plateforme Cortex-A53 que T2 mais ajoute 32 Go de flash, un modem LTE Cat-1 en option et la surface complète de streaming webhook. Le SDK expose 42 fonctions — les mêmes que la surface API REST cloud — plus 6 types d'événements webhook qui poussent les événements de lecture en temps réel vers un endpoint partenaire. La batterie est de 2 000 mAh avec une autonomie de 11 h. Y6 est la référence OEM flagship pour les éditeurs qui veulent le flux d'événements complet et l'option de connectivité cellulaire pour les écoles avec un Wi-Fi irrégulier.
4. La surface SDK, cartographiée
Le SDK est livré sous forme de bibliothèque statique plus un fichier d'en-tête. Nous fournissons des liaisons C, C++ et Swift, avec des liaisons Java et Kotlin ajoutées dans le firmware 2.6.4 pour les intégrations Android. La charge utile totale est de 1,8 Mo compressé. Les trois stylos Full-SDK partagent le même package SDK — les partenaires n'ont qu'à changer la cible de build.
5. La surface de l'API REST
L'API REST cloud est l'équivalent partenaire du SDK. Nous exposons 42 endpoints répartis en 7 groupes fonctionnels : catalogue, inventaire, tarification, commandes, expéditions, conformité et webhooks. Le flux complet OAuth 2.0 client-credentials, le profil de limite de débit (1 000 req/min standard, 10 000 req/min niveau partenaire) et la latence p95 de 180 ms sont documentés dans le portail partenaire.
| Groupe | Endpoints | Hot Path ? |
|---|---|---|
| Catalogue | 8 | Oui |
| Inventaire | 4 | Oui |
| Tarification | 6 | Oui |
| Commandes | 8 | Oui |
| Expéditions | 5 | Oui |
| Conformité | 4 | Non |
| Webhooks | 7 | Oui |
Une intégration OEM typique utilise 14 à 22 des 42 endpoints. L'intégration viable minimale nécessite 6 endpoints : lecture produit catalogue, devis tarifaire, création commande, lecture commande, lecture expédition et enregistrement webhook.
6. Les 7 types d'événements Webhook
La livraison Webhook est la demande la plus fréquente des partenaires éditeurs. Les 7 types d'événements couvrent l'ensemble du cycle de vie de la lecture.
| Événement | Quand déclenché | Taille de la charge utile | Cas d'utilisation |
|---|---|---|---|
oid.scan |
L'utilisateur tape sur un mot | 0,4 Ko | Analytique du vocabulaire |
session.start |
L'utilisateur met sous tension | 0,2 Ko | Suivi de l'engagement |
session.end |
Délai d'inactivité de 5 min | 0,2 Ko | Analyse du taux de désabonnement |
audio.play |
L'audio démarre | 0,3 Ko | Utilisation du contenu |
battery.low |
Batterie ≤ 15% | 0,1 Ko | Alerte de flotte |
firmware.update |
Mise à jour OTA terminée | 0,2 Ko | Piste d'audit |
device.error |
L'auto-test échoue | 0,4 Ko | Suivi de la garantie |
Les tentatives de livraison Webhook utilisent un backoff exponentiel à 1, 5, 30, 120 et 600 secondes. Le temps de livraison au 99e percentile sur 142 intégrations en production est de 2,1 secondes.
7. SDK vs. REST : Quand utiliser lequel
Le SDK fonctionne sur l'appareil. L'API REST fonctionne dans le cloud. Les deux peuvent fournir les mêmes données d'événement, mais ils répondent à des questions différentes.
La plupart des intégrations OEM utilisent les deux couches. Le SDK alimente l'application partenaire en temps réel ; l'API REST alimente l'entrepôt de données partenaire du jour au lendemain.
8. Calendrier d'intégration de l'échantillon à la production
Une intégration OEM typique prend 21 jours. Nous avons observé que le calendrier se compresse à 14 jours lorsque le partenaire dispose d'un ingénieur d'intégration dédié sur le projet.
| Jour | Jalon | Responsable |
|---|---|---|
| 0 | Accord de confidentialité signé, kit d'échantillon expédié | Usine |
| 1–3 | Kit d'échantillon reçu, déballage | Partenaire |
| 4–7 | Test SDK spike, test de scan OID | Partenaire |
| 8–10 | Client OAuth 2.0 émis | Usine |
| 11–14 | Test smoke du point de terminaison REST | Commun |
| 15–17 | Point de terminaison Webhook en direct | Conjoint |
| 18–20 | Série pilote 50–200 unités | Partenaire |
| 21 | Bon de production autorisé | Partenaire |
Pour les programmes de plus de 5 000 unités, nous recommandons d'ajouter un test de rodage de 30 jours entre le jour 17 et le jour 21 pour détecter les cas limites de roaming Wi-Fi.
9. Tarification et MOQ pour les stylets SDK
La tarification est échelonnée par modèle, MOQ et niveau SDK. Le tableau ci-dessous présente nos tarifs de référence T3-2026 pour les trois modèles SDK complets.
| Modèle | MOQ | Prix FOB / Unité (commande de 500 unités) | Prix FOB / Unité (commande de 5 000 unités) | Licence SDK |
|---|---|---|---|---|
| P2 | 500 | 11,20 $ | 9,40 $ | Incluse |
| T2 | 500 | 13,80 $ | 11,50 $ | Incluse |
| Y6 | 500 | 14,50 $ | 12,20 $ | Incluse |
Les trois modèles incluent la licence SDK et l'accès à l'API REST cloud sans frais supplémentaires au-delà du prix unitaire. Les forks de firmware personnalisés, les endpoints cloud private-label et les domaines webhook dédiés sont chiffrés séparément, généralement à partir de 4 800 $ par flux de travail.
11. Recommandation de Mix Modèles selon les Scénarios d'Intégration
La gamme de 11 modèles correspond à quatre scénarios d'achat distincts. Le mix ci-dessous est la moyenne sur 47 programmes OEM que nous avons livrés depuis 2023.
| Scénario | Part P2 | Part T2 | Part Y6 | Autres |
|---|---|---|---|---|
| Publisher OEM, mobile-first | 50 % | 35 % | 15 % | 0 % |
| Flotte scolaire, chariot partagé | 5 % | 80 % | 15 % | 0 % |
| 1:1 à emporter, Wi-Fi hybride | 10 % | 35 % | 55 % | 0 % |
| Chaîne parascolaire / tutorat | 40 % | 45 % | 15 % | 0 % |
Pour la plupart des programmes OEM de plus de 5 000 unités, le mix typique est de 30 % P2, 50 % T2 et 20 % Y6. Les éditeurs qui ont besoin d'une seule référence entre les déploiements mobiles et scolaires standardisent souvent sur Y6 seul, acceptant la prime LTE pour la simplicité opérationnelle.
12. Parcours de mise à jour firmware année 2
Les partenaires OEM nous interrogent sur la feuille de route du firmware. Le tableau ci-dessous présente le chemin de firmware publié pour les trois modèles full-SDK.
| Modèle | Actuel | Suivant (T4 2026) | T2 2027 |
|---|---|---|---|
| P2 | 2.0.3 | 2.0.4 (correctifs de bugs) | 2.1.0 (nouveau codec OID) |
| T2 | 2.6.4 | 2.6.5 (sécurité) | 2.7.0 (Wi-Fi basse consommation) |
| Y6 | 2.6.4 | 2.6.5 (sécurité) | 2.7.0 (optimisation de la consommation LTE) |
Les mises à niveau de version majeure (ex. 2.x vers 3.x) sont livrées avec une fenêtre de compatibilité ascendante de 6 mois. Les partenaires sont informés 90 jours avant tout changement cassant.