Khalayak Sasaran: Artikel ini ditulis untuk ketua jurutera, pengurus program OEM, dan arkitek platform EdTech yang perlu membenamkan acara pen bacaan ke dalam aplikasi ibu bapa, LMS sekolah, atau suite pembelajaran penerbit. Pembaca sekunder termasuk penyepaduan firmware yang menilai pertukaran antara SDK dan REST mentah.
Kebanyakan pen bacaan di pasaran masih dihantar sebagai peranti tertutup. Anda tunjuk, anda ketuk, audio dimainkan, habis cerita. Untuk program OEM atau platform penerbit yang perlu menangkap acara bacaan, menyegerakkan kemajuan, dan mencetuskan kandungan adaptif, itu tidak cukup. Anda memerlukan pen bacaan dengan SDK sebenar dan REST API yang terdokumentasi. Pasukan kejuruteraan Smart Reading Pen telah mengeluarkan 86 keluaran firmware sejak 2023, dan tiga model semasa kami — P2, T2, dan Y6 — diposisikan khusus untuk pihak yang membuat penyepaduan. Panduan ini membandingkan permukaan SDK, titik akhir API, dan aliran kerja onboarding yang membawa rakan kongsi dari kotak sampel kepada pengeluaran OEM 5,000 unit.
1. Mengapa Liputan SDK dan API Penting untuk Program OEM
Program OEM lebih daripada sekadar pen label peribadi. Ia ialah kontrak yang menyatakan: setiap acara yang dipancarkan pen akan tiba di gudang analitik rakan kongsi kami. Jika firmware tertutup dan awan dikunci, rakan kongsi bergantung kepada kami untuk mengeluarkan ciri. Jika kami menghantar SDK dan REST API, rakan kongsi memiliki penyepaduan dan boleh menghantar mengikut roadmap mereka sendiri.
Dalam data pengeluaran 2023–2026 kami, 11 program OEM yang menggunakan SDK menghantar purata 4.7 keluaran ciri setahun berbanding 1.3 yang kami hantar pada SKU firmware tertutup. Rakan kongsi OEM juga mengekalkan pelanggan pada kadar 92% berbanding 71% untuk SKU firmware tertutup dalam tempoh tetingkap 24 bulan yang sama. Liputan SDK secara langsung mendorong pengekalan.
Tip pembeli: Tanya setiap kilang yang calon sama ada mereka akan menandatangani NDA, memberi anda pakej SDK sampel, dan membenarkan jurutera anda menjalankan ujian spike 5 hari sebelum mana-mana PO ditandatangani. Jika jawapannya ialah "kita bincang selepas PO," undur diri.
2. 11 Model Pen Bacaan dan Kedudukan Mereka di Tangga Penyepaduan
Kesemua 11 model dalam barisan 2026 kami mendedahkan beberapa bentuk data acara, tetapi hanya tiga daripadanya membawa permukaan SDK + REST penuh yang diperlukan oleh pihak yang membuat penyepaduan OEM. Lapan lagi direka untuk kes penggunaan runcit atau pakej sekolah di mana firmware tertutup boleh diterima.
| Model | Firmware | Bateri | Ketersambungan | Tahap SDK | Kesesuaian Terbaik |
|---|---|---|---|---|---|
| B1 | 2.4.7 | 700 mAh / 5.0 j | USB-C sahaja | Tiada | Runcit, kemasukan bawah $10 |
| B2 | 2.4.7 | 800 mAh / 5.5 j | USB-C sahaja | Tiada | Runcit, bateri sedikit lebih besar |
| F8 | 3.1.2 | 600 mAh / 4.5 j | USB-C, bicu 3.5 mm | Log sahaja | Pakej sekolah, penggunaan luar talian |
| K7 | 1.9.5 | 800 mAh Li-ion 14500 / 6.0 j | USB-C, BT 4.2 | Log sahaja | Pakej permulaan K–3 |
| KF1 | 1.9.5 | 800 mAh Li-ion 14500 / 6.0 j | USB-C, BT 5.0 | Log sahaja | Pakej permulaan K–3 dengan BT |
| L5 | 4.2.0 | 1,200 mAh / 8.5 j | USB-C, BT 5.0, Wi-Fi 2.4 GHz | SDK Separa | Runcit premium, cangkuk acara separa |
| P2 | 2.0.3 | 500 mAh / 4.0 j | USB-C, BT 5.0 | SDK + REST Penuh | EdTech OEM, pen ringan |
| Q6 | 3.3.1 | 900 mAh / 6.5 j | USB-C, BT 5.0 | Log sahaja | Runcit pasaran pertengahan |
| Q8 | 3.3.1 | 1,000 mAh / 7.0 j | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz | SDK separa | Runcit premium, aplikasi ibu bapa |
| T2 | 2.6.4 | 2,500 mAh Li-ion 18650 / 14 j | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz | SDK Penuh + REST | Armada sekolah, OEM |
| Y6 | 2.6.4 | 2,000 mAh / 11 j | USB-C, BT 5.0, Wi-Fi 2.4/5 GHz, LTE Cat-1 pilihan | SDK Penuh + REST + Webhook | OEM flagship, sekolah + rumah |
Coraknya jelas. Apabila anda naik ke barisan lebih atas, permukaan SDK, ketersambungan dan bateri semuanya berkembang. P2 ialah pen SDK penuh paling ringan pada 38 g, T2 mempunyai jangka hayat bateri paling panjang, dan Y6 ialah satu-satunya dengan LTE pilihan untuk penggunaan armada di mana Wi-Fi tidak boleh dipercayai.
3. P2, T2, Y6: Tiga Model SDK Penuh
Apabila integrator meminta kami "pen bacaan terbaik dengan SDK dan integrasi API," kami menunjuk mereka kepada P2, T2, dan Y6. Setiap satu merangkumi kes penggunaan yang berbeza.
3.1 P2 — Pen OEM Ringan
P2 menjalankan firmware 2.0.3 pada MCU dwiteras dengan 4 MB flash. SDK mendedahkan 18 fungsi: 6 untuk acara imbasan OID, 4 untuk main balik audio, 4 untuk keadaan peranti (bateri, butang, melahu), 2 untuk sesi pengguna, dan 2 untuk firmware OTA. Bateri ialah 500 mAh dengan jangka masa jalan 4.0 j, yang terendah dalam barisan tetapi juga mengekalkan berat pada 38 g. P2 ialah jawapan yang tepat untuk penerbit yang membenamkan pen di dalam siri buku cerita dan memerlukan tangkapan OID serta main balik audio yang disambungkan ke aplikasi ibu bapa.
3.2 T2 — Kuda Kerja Armada Sekolah
T2 menjalankan firmware 2.6.4 pada Cortex-A53 kuadtteras dengan 16 GB flash. SDK mendedahkan 32 fungsi: 6 untuk OID, 4 untuk audio, 6 untuk sesi Wi-Fi, 4 untuk keadaan, 4 untuk pengguna dan bilik darjah, 4 untuk OTA, dan 4 untuk diagnostik. Bateri ialah 2,500 mAh Li-ion 18650 dengan jangka masa jalan 14 j, yang mencukupi untuk sehari persekolahan penuh K–8. T2 ialah pilihan standard untuk armada sekolah 12,000 unit di mana integrasi perlu bertahan selama 18 bulan penggunaan harian.
3.3 Y6 — Pen OEM Flagship dengan Penstriman Webhook
Y6 menjalankan firmware 2.6.4 pada platform Cortex-A53 yang sama seperti T2 tetapi menambah 32 GB flash, modem LTE Cat-1 pilihan, dan permukaan penstriman webhook penuh. SDK mendedahkan 42 fungsi — sama dengan permukaan API REST awan — ditambah 6 jenis acara webhook yang menolak acara bacaan dalam masa nyata ke titik akhir rakan kongsi. Bateri ialah 2,000 mAh dengan jangka masa jalan 11 j. Y6 ialah SKU OEM flagship untuk penerbit yang inginkan strim acara penuh dan pilihan ketersambungan selular untuk sekolah dengan Wi-Fi yang tidak stabil.
4. Permukaan SDK, Dipetakan
SDK dihantar sebagai perpustakaan statik ditambah fail pengepala. Kami menghantar pengikatan C, C++, dan Swift, dengan pengikatan Java dan Kotlin ditambah dalam firmware 2.6.4 untuk integrasi Android. Jumlah muatan ialah 1.8 MB dimampatkan. Ketiga-tiga pen SDK penuh berkongsi pakej SDK yang sama — rakan kongsi hanya perlu menukar sasaran build.
5. Permukaan API REST
API REST awan ialah setara SDK yang menghadap rakan kongsi. Kami mendedahkan 42 titik akhir merentasi 7 kumpulan berfungsi: katalog, inventori, harga, pesanan, penghantaran, pematuhan, dan webhook. Aliran bukti kelayakan klien OAuth 2.0 penuh, profil had kadar (1,000 req/min standard, 10,000 req/min peringkat rakan kongsi), dan kependaman p95 sebanyak 180 ms didokumentasikan dalam portal rakan kongsi.
| Kumpulan | Titik akhir | Laluan Panas? |
|---|---|---|
| Katalog | 8 | Ya |
| Inventori | 4 | Ya |
| Harga | 6 | Ya |
| Pesanan | 8 | Ya |
| Penghantaran | 5 | Ya |
| Pematuhan | 4 | Tidak |
| Webhook | 7 | Ya |
Integrasi OEM biasa menggunakan 14–22 daripada 42 titik akhir. Integrasi minimum yang berdaya maju memerlukan 6: bacaan produk katalog, sebut harga, cipta pesanan, bacaan pesanan, bacaan penghantaran, dan pendaftaran webhook.
6. 7 Jenis Acara Webhook
Penghantaran webhook ialah permintaan paling biasa daripada rakan kongsi penerbit. 7 jenis acara ini merangkumi kitaran hayat bacaan sepenuhnya.
| Acara | Bila Dihantar | Saiz Muatan | Kes Penggunaan |
|---|---|---|---|
oid.scan |
Pengguna mengetik perkataan | 0.4 KB | Analitik perbendaharaan kata |
session.start |
Pengguna menghidupkan peranti | 0.2 KB | Penjejakan penglibatan |
session.end |
Tamat masa melahu 5 minit | 0.2 KB | Analisis keciciran |
audio.play |
Audio mula dimainkan | 0.3 KB | Penggunaan kandungan |
battery.low |
Bateri ≤ 15% | 0.1 KB | Peringatan armada peranti |
firmware.update |
OTA selesai | 0.2 KB | Jejak audit |
device.error |
Ujian kendiri gagal | 0.4 KB | Penjejakan waranti |
Penghantaran webhook akan dicuba semula dengan backoff eksponen pada 1, 5, 30, 120 dan 600 saat. Masa penghantaran persentil ke-99 merentasi 142 integrasi pengeluaran ialah 2.1 saat.
7. SDK lwn REST: Bila Menggunakan Yang Mana
SDK berjalan pada peranti. API REST berjalan di awan. Kedua-duanya boleh menghantar data acara yang sama, tetapi menjawab persoalan yang berbeza.
Kebanyakan integrasi OEM menggunakan kedua-dua lapisan. SDK menyuapkan aplikasi rakan kongsi secara masa nyata; API REST menyuapkan gudang data rakan kongsi pada waktu malam.
8. Garis Masa Onboarding daripada Kotak Sampel hingga Pengeluaran
Onboarding OEM biasa mengambil masa 21 hari. Kami pernah melihat garis masa dipendekkan kepada 14 hari apabila rakan kongsi mempunyai jurutera integrasi khusus untuk projek ini.
| Hari | Pencapaian | Pemilik |
|---|---|---|
| 0 | NDA ditandatangani, kit sampel dihantar | Kilang |
| 1–3 | Kit sampel diterima, dibuka | Rakan Kongsi |
| 4–7 | Ujian SDK, ujian imbasan OID | Rakan Kongsi |
| 8–10 | Klien OAuth 2.0 dikeluarkan | Kilang |
| 11–14 | Ujian asap titik akhir REST | Bersama |
| 15–17 | Titik akhir webhook aktif | Joint |
| 18–20 | Pengeluaran percubaan 50–200 unit | Rakan Kongsi |
| 21 | PO pengeluaran diluluskan | Rakan Kongsi |
Untuk program melebihi 5,000 unit, kami mengesyorkan menambah ujian rendaman 30 hari antara hari ke-17 dan hari ke-21 bagi mengesan kes-kes tepi roaming Wi-Fi.
9. Harga dan MOQ untuk Pen Berdayakan SDK
Harga berperingkat mengikut model, MOQ, dan tahap SDK. Jadual di bawah menunjukkan harga rujukan Suku-3 2026 kami untuk tiga model SDK penuh.
| Model | MOQ | Harga FOB / Unit (pesanan 500 unit) | Harga FOB / Unit (pesanan 5,000 unit) | Lesen SDK |
|---|---|---|---|---|
| P2 | 500 | $11.20 | $9.40 | Disertakan |
| T2 | 500 | $13.80 | $11.50 | Disertakan |
| Y6 | 500 | $14.50 | $12.20 | Disertakan |
Ketiga-tiganya termasuk lesen SDK dan akses API REST awan tanpa bayaran tambahan melebihi harga unit. Fork firmware tersuai, titik akhir awan label peribadi, dan domain webhook khusus akan diberikan sebut harga berasingan, biasanya bermula pada $4,800 setiap aliran kerja.
11. Cadangan Campuran Model Merentasi Senario Integrasi
Barisan 11 model ini memetakan kepada empat senario pembeli yang berbeza. Campuran di bawah adalah purata merentasi 47 program OEM yang telah kami hantar sejak 2023.
| Senario | Bahagian P2 | Bahagian T2 | Bahagian Y6 | Lain-lain |
|---|---|---|---|---|
| Penerbit OEM, mudah alih-pertama | 50% | 35% | 15% | 0% |
| Armada sekolah, troli dikongsi | 5% | 80% | 15% | 0% |
| Bawa pulang 1:1, Wi-Fi hibrid | 10% | 35% | 55% | 0% |
| Rantai selepas sekolah / tuisyen | 40% | 45% | 15% | 0% |
Untuk kebanyakan program OEM melebihi 5,000 unit, campuran lazim ialah 30% P2, 50% T2, dan 20% Y6. Penerbit yang memerlukan satu SKU merentasi penggunaan mudah alih dan sekolah sering memiawaikan pada Y6 sahaja, menerima premium LTE untuk kesederhanaan operasi.
12. Laluan Kemas Kini Firmware Tahun ke-2
Rakan kongsi OEM sering bertanya tentang hala tuju firmware kami. Jadual di bawah menunjukkan laluan firmware yang diterbitkan untuk tiga model SDK penuh.
| Model | Semasa | Seterusnya (S4 2026) | S2 2027 |
|---|---|---|---|
| P2 | 2.0.3 | 2.0.4 (pembetulan pepijat) | 2.1.0 (kodek OID baharu) |
| T2 | 2.6.4 | 2.6.5 (keselamatan) | 2.7.0 (Wi-Fi berkuasa rendah) |
| Y6 | 2.6.4 | 2.6.5 (keselamatan) | 2.7.0 (pengoptimuman kuasa LTE) |
Naik taraf versi utama (contohnya, 2.x ke 3.x) dihantar dengan tempoh keserasian belakang selama 6 bulan. Rakan kongsi dimaklumkan 90 hari sebelum sebarang perubahan pecah.