Audiență: Acest articol este scris pentru responsabilii de inginerie, managerii de programe OEM și arhitecții de platforme EdTech care trebuie să integreze evenimentele stiloului de citire într-o aplicație pentru părinți, într-un LMS școlar sau într-o suită de învățare a unui editor. Cititorii secundari includ integratorii de firmware care evaluează compromisul dintre SDK și REST brut.
Majoritatea stylus-urilor de citire de pe piață încă sunt livrate ca dispozitive închise. Arăți, apeși, redă audio, povestea se termină așa. Pentru un program OEM sau o platformă de editor care trebuie să captureze evenimente de citire, să sincronizeze progresul și să declanșeze conținut adaptiv, acest lucru nu este suficient. Ai nevoie de un stilou de citire cu un SDK real și un API REST documentat. Echipa de inginerie Smart Reading Pen a livrat 86 de versiuni de firmware din 2023, iar trei dintre modelele noastre actuale — P2, T2 și Y6 — sunt poziționate special pentru integratori. Acest ghid compară suprafața SDK, endpoint-urile API și fluxul de onboarding care duce un partener de la o cutie de mostre la o producție OEM de 5.000 de unități.
1. De ce contează acoperirea SDK și API pentru programele OEM
Un program OEM este mai mult decât un stilou cu etichetă privată. Este un contract care spune: fiecare eveniment pe care îl emite stiloul va ajunge în depozitul de analiză al partenerului nostru. Dacă firmware-ul este închis și cloud-ul este blocat, partenerul depinde de noi pentru a lansa funcționalități. Dacă livrăm un SDK și un API REST, partenerul deține integrarea și poate lansa conform propriului roadmap.
În datele noastre de producție 2023–2026, cele 11 programe OEM care au consumat SDK-ul au lansat în medie 4,7 versiuni de funcționalități pe an față de 1,3 lansate pe SKU-urile cu firmware închis. Partenerii OEM au păstrat și clienți cu o rată de 92% față de 71% pentru SKU-urile cu firmware închis în aceeași fereastră de 24 de luni. Acoperirea SDK conduce direct retenția.
Sfat pentru cumpărător: Întreabă fiecare fabrică candidată dacă va semna un NDA, îți va pune la dispoziție un pachet SDK de probă și le va permite inginerilor tăi să ruleze un spike de 5 zile înainte de semnarea oricărui PO. Dacă răspunsul este „vom discuta după PO", pleacă.
2. Cele 11 modele de stilou de citire și unde se situează pe scara integrării
Toate cele 11 modele din gama noastră 2026 expun o formă de date despre evenimente, dar doar trei dintre ele oferă întreaga suprafață SDK + REST de care au nevoie integratorii OEM. Celelalte opt sunt concepute pentru retail sau pentru pachete școlare unde un firmware închis este acceptabil.
| Model | Firmware | Baterie | Conectivitate | Nivel SDK | Cea mai bună utilizare |
|---|---|---|---|---|---|
| B1 | 2.4.7 | 700 mAh / 5,0 h | Doar USB-C | Niciunul | Retail, intrare sub 10 $ |
| B2 | 2.4.7 | 800 mAh / 5,5 h | Doar USB-C | Niciunul | Retail, baterie ușor mai mare |
| F8 | 3.1.2 | 600 mAh / 4,5 h | USB-C, jack 3,5 mm | Doar log | Pachete școlare, utilizare offline |
| K7 | 1.9.5 | 800 mAh Li-ion 14500 / 6,0 h | USB-C, BT 4.2 | Doar log | Pachete starter K–3 |
| KF1 | 1.9.5 | 800 mAh Li-ion 14500 / 6,0 h | USB-C, BT 5.0 | Doar log | Pachete starter K–3 cu BT |
| L5 | 4.2.0 | 1.200 mAh / 8,5 h | USB-C, BT 5.0, Wi-Fi 2,4 GHz | SDK parțial | Retail premium, hook-uri parțiale de evenimente |
| P2 | 2.0.3 | 500 mAh / 4,0 h | USB-C, BT 5.0 | SDK complet + REST | EdTech OEM, stilou ușor |
| Q6 | 3.3.1 | 900 mAh / 6,5 h | USB-C, BT 5.0 | Doar jurnalizare | Retail segment mediu |
| Q8 | 3.3.1 | 1.000 mAh / 7,0 h | USB-C, BT 5.0, Wi-Fi 2,4/5 GHz | SDK parțial | Retail premium, aplicație parentală |
| T2 | 2.6.4 | 2.500 mAh Li-ion 18650 / 14 h | USB-C, BT 5.0, Wi-Fi 2,4/5 GHz | SDK complet + REST | Flotă școlară, OEM |
| Y6 | 2.6.4 | 2.000 mAh / 11 h | USB-C, BT 5.0, Wi-Fi 2,4/5 GHz, LTE Cat-1 opțional | SDK complet + REST + Webhook | OEM flagship, școală + acasă |
Modelul este clar. Pe măsură ce urci în gamă, suprafața SDK, conectivitatea și bateria se extind. P2 este cel mai ușor stilou cu SDK complet la 38 g, T2 are cea mai lungă autonomie, iar Y6 este singurul cu LTE opțional pentru implementări în flotă unde Wi-Fi este nesigur.
3. P2, T2, Y6: Cele trei modele cu SDK complet
Când integratorii ne solicită „cel mai bun stilou de citit cu SDK și integrare API", îi îndrumăm către P2, T2 și Y6. Fiecare acoperă un caz de utilizare distinct.
3.1 P2 — Stiloul OEM ușor
P2 rulează firmware 2.0.3 pe un MCU dual-core cu 4 MB flash. SDK-ul expune 18 funcții: 6 pentru evenimente de scanare OID, 4 pentru redare audio, 4 pentru starea dispozitivului (baterie, buton, inactivitate), 2 pentru sesiune utilizator și 2 pentru firmware OTA. Bateria este de 500 mAh cu autonomie de 4,0 h, cea mai mică din gamă, dar menține greutatea la 38 g. P2 este răspunsul potrivit pentru un editor care încorporează stiloul într-o serie de cărți de povești și are nevoie de captură OID și redare audio integrate în aplicația parentală.
3.2 T2 — Calul de povară pentru flote școlare
T2 rulează firmware 2.6.4 pe un Cortex-A53 quad-core cu 16 GB flash. SDK-ul expune 32 de funcții: 6 pentru OID, 4 pentru audio, 6 pentru sesiune Wi-Fi, 4 pentru stare, 4 pentru utilizator și clasă, 4 pentru OTA și 4 pentru diagnosticare. Bateria este de 2.500 mAh Li-ion 18650 cu autonomie de 14 h, suficient pentru o zi școlară completă K–8. T2 este alegerea standard pentru o flotă școlară de 12.000 de unități în care integrarea trebuie să reziste 18 luni de utilizare zilnică.
3.3 Y6 — Stiloul OEM flagship cu streaming Webhook
Y6 rulează firmware 2.6.4 pe aceeași platformă Cortex-A53 ca T2, dar adaugă 32 GB flash, un modem LTE Cat-1 opțional și întreaga suprafață de streaming prin webhook. SDK-ul expune 42 de funcții — aceleași ca suprafața API REST cloud — plus 6 tipuri de evenimente webhook care trimit evenimentele de citire în timp real către un endpoint partener. Bateria este de 2.000 mAh cu autonomie de 11 h. Y6 este SKU-ul OEM flagship pentru editorii care doresc fluxul complet de evenimente și opțiunea conectivității celulare pentru școli cu Wi-Fi instabil.
4. Suprafața SDK, cartografiată
SDK-ul este livrat ca bibliotecă statică plus un fișier header. Furnizăm bindinguri C, C++ și Swift, cu bindinguri Java și Kotlin adăugate în firmware 2.6.4 pentru integrări Android. Payload-ul total este de 1,8 MB comprimat. Toate cele trei stilouri cu SDK complet partajează același pachet SDK — partenerii trebuie doar să schimbe targetul de build.
5. Suprafața API REST
API-ul REST cloud este echivalentul SDK-ului orientat către parteneri. Expunem 42 de endpoint-uri în 7 grupuri funcționale: catalog, inventar, prețuri, comenzi, expedieri, conformitate și webhooks. Fluxul complet OAuth 2.0 client-credentials, profilul de rate-limit (1.000 req/min standard, 10.000 req/min nivel partener) și latența p95 de 180 ms sunt documentate în portalul partenerilor.
| Grup | Endpoint-uri | Pe calea critičă? |
|---|---|---|
| Catalog | 8 | Da |
| Inventar | 4 | Da |
| Prețuri | 6 | Da |
| Comenzi | 8 | Da |
| Expedieri | 5 | Da |
| Conformitate | 4 | Nu |
| Webhooks | 7 | Da |
O integrare OEM tipică folosește 14–22 dintre cele 42 de endpoint-uri. Integrarea minim viabilă necesită 6: citire produs catalog, ofertă preț, creare comandă, citire comandă, citire expediere și înregistrare webhook.
6. Cele 7 tipuri de evenimente Webhook
Livrarea prin Webhook este cea mai frecventă solicitare din partea partenerilor editori. Cele 7 tipuri de evenimente acoperă întregul ciclu de citire.
| Eveniment | Când se declanșează | Dimensiunea payload-ului | Caz de utilizare |
|---|---|---|---|
oid.scan |
Utilizatorul atinge un cuvânt | 0,4 KB | Analiză de vocabular |
session.start |
Utilizatorul pornește dispozitivul | 0,2 KB | Monitorizarea angajamentului |
session.end |
Timeout 5 min de inactivitate | 0,2 KB | Analiza pierderilor de utilizatori |
audio.play |
Audio începe | 0,3 KB | Utilizarea conținutului |
battery.low |
Baterie ≤ 15% | 0,1 KB | Alertare flotă |
firmware.update |
Finalizare OTA | 0,2 KB | Jurnal de audit |
device.error |
Eșec al autotestării | 0,4 KB | Urmărire garanție |
Livrarea Webhook se reîncearcă cu backoff exponențial la 1, 5, 30, 120 și 600 de secunde. Timpul de livrare la percentila 99 din 142 de integrări în producție este de 2,1 secunde.
7. SDK vs. REST: Când să folosiți care
SDK-ul rulează pe dispozitiv. API-ul REST rulează în cloud. Ambele pot furniza aceleași date despre evenimente, dar răspund la întrebări diferite.
Majoritatea integrărilor OEM utilizează ambele niveluri. SDK-ul alimentează aplicația partenerului în timp real; API-ul REST alimentează data warehouse-ul partenerului peste noapte.
8. Cronologia de onboarding de la cutia de mostre la producție
Un onboarding OEM tipic durează 21 de zile. Am constatat că această cronologie se poate comprima la 14 zile atunci când partenerul are un inginer de integrare dedicat proiectului.
| Ziua | Repere | Responsabil |
|---|---|---|
| 0 | NDA semnat, kit de mostre expediat | Fabrică |
| 1–3 | Kit de mostre recepționat, despachetare | Partener |
| 4–7 | Test SDK, test scanare OID | Partener |
| 8–10 | Client OAuth 2.0 emis | Fabrică |
| 11–14 | Test de fum endpoint REST | Comun |
| 15–17 | Endpoint Webhook activ | Joint |
| 18–20 | Lot pilot 50–200 unități | Partener |
| 21 | Comandă de producție autorizată | Partener |
Pentru programele de peste 5.000 de unități, recomandăm adăugarea unui test de imersie de 30 de zile între ziua 17 și ziua 21 pentru a detecta cazurile limită de roaming Wi-Fi.
9. Prețuri și MOQ pentru pixurile cu SDK
Prețurile sunt diferențiate în funcție de model, MOQ și nivelul SDK. Tabelul de mai jos prezintă prețurile noastre de referință pentru T3-2026 pentru cele trei modele cu SDK complet.
| Model | MOQ | Preț FOB / unitate (comandă de 500 unități) | Preț FOB / unitate (comandă de 5.000 unități) | Licență SDK |
|---|---|---|---|---|
| P2 | 500 | $11.20 | $9.40 | Inclusă |
| T2 | 500 | $13.80 | $11.50 | Inclusă |
| Y6 | 500 | $14.50 | $12.20 | Inclusă |
Toate cele trei includ licența SDK și accesul la API-ul REST cloud fără nicio taxă suplimentară peste prețul unitar. Versiunile personalizate de firmware, endpoint-urile cloud cu marcă privată și domeniile dedicate de webhook sunt cotate separat, de obicei începând de la 4.800 $ per flux de lucru.
11. Recomandare de mix de modele pentru scenarii de integrare
Gama de 11 modele se mapează pe patru scenarii distincte de cumpărător. Mixul de mai jos este media pe 47 de programe OEM pe care le-am livrat din 2023.
| Scenariu | Cotă P2 | Cotă T2 | Cotă Y6 | Altele |
|---|---|---|---|---|
| Editor OEM, orientat pe mobil | 50% | 35% | 15% | 0% |
| Flotă școlară, carucior partajat | 5% | 80% | 15% | 0% |
| 1:1 luat acasă, Wi-Fi hibrid | 10% | 35% | 55% | 0% |
| Lanț after-school / meditații | 40% | 45% | 15% | 0% |
Pentru majoritatea programelor OEM de peste 5.000 de unități, mixul tipic este 30% P2, 50% T2 și 20% Y6. Editorii care au nevoie de un singur SKU pentru implementări mobile și școlare standardizează adesea doar pe Y6, acceptând premium-ul LTE pentru simplitatea operațională.
12. Traseul de actualizare firmware în anul 2
Partenerii OEM ne întreabă despre planul de dezvoltare al firmware-ului. Tabelul de mai jos prezintă traseul publicat al firmware-ului pentru cele trei modele cu SDK complet.
| Model | Actual | Următorul (T4 2026) | T2 2027 |
|---|---|---|---|
| P2 | 2.0.3 | 2.0.4 (rezolvări de erori) | 2.1.0 (codec OID nou) |
| T2 | 2.6.4 | 2.6.5 (securitate) | 2.7.0 (Wi-Fi cu consum redus) |
| Y6 | 2.6.4 | 2.6.5 (securitate) | 2.7.0 (optimizare consum LTE) |
Upgrade-urile majore de versiune (de ex., 2.x la 3.x) sunt livrate cu o fereastră de compatibilitate inversă de 6 luni. Partenerii sunt notificați cu 90 de zile înainte de orice schimbare majoră.