Khalayak sasaran: Artikel ini menyasarkan pengurus produk dan jurutera integrasi di penerbit aplikasi ibu bapa, platform SaaS sekolah, dan penerbit buku OID yang perlu membenamkan pena bacaan ke dalam aplikasi pihak ketiga sedia ada. Pembaca sekunder termasuk pengedar yang menilai sama ada untuk membundel aplikasi rakan kongsi dengan pena tersebut.
Pena bacaan yang tidak berkomunikasi dengan aplikasi pihak ketiga hanyalah mainan kendiri. Pena bacaan yang berkomunikasi sebaliknya ialah sambungan perkakasan kepada produk anda. Soalan yang paling kerap ditanya oleh pembeli kepada kami ialah: "Antara 11 model anda, yang manakah boleh menghantar peristiwa bacaan ke aplikasi kami, dan berapa lama masa yang diambil untuk integrasi?" Jawapan jujurnya ialah lapan daripada sebelas model boleh berbuat demikian, tetapi hanya tiga — P2, T2, dan Y6 — mendedahkan permukaan yang mencukupi untuk integrasi pihak ketiga yang serius. Panduan ini membimbing anda melalui lapisan ketersambungan, kontrak data, dan senarai semak QA yang membawa rakan kongsi daripada sampel 50 unit kepada pengeluaran OEM 10,000 unit.
1. Tiga Tahap Integrasi
Kami menggredkan pena kami mengikut sejauh mana permukaan peranti boleh dikawal oleh aplikasi rakan kongsi. Tahap 1 ialah "log sahaja" — pena merakam peristiwa dan memuat naiknya secara pukal. Tahap 2 ialah "SDK separa" — pena mendedahkan satu set fungsi terpilih. Tahap 3 ialah "SDK penuh + REST" — pena mendedahkan permukaan peristiwa lengkap serta API REST awan dan penstriman webhook.
| Tahap | Model | Kiraan Fungsi | UX Terbena dalam Aplikasi |
|---|---|---|---|
| Tiada | B1, B2 | 0 | Tidak disokong |
| Log sahaja | F8, K7, KF1, Q6 | 0 | Muat turun CSV |
| SDK separa | L5, Q8 | 14–18 | Terhad |
| SDK penuh + REST | P2, T2, Y6 | 18, 32, 42 | Penuh |
Bagi aplikasi ibu bapa pihak ketiga yang memerlukan maklum balas bacaan secara langsung — "Maya mengetik 'elephant' pada pukul 3:42 petang, memainkan audio, melihat terjemahan bahasa Sepanyol" — hanya Tahap 3 yang berkesan. F8, K7, KF1, dan Q6 boleh menolak log CSV tetapi tidak dapat menstrim peristiwa secara langsung.
Tip pembeli: Apabila sebuah kilang memberitahu anda pena mereka "menyokong integrasi aplikasi," minta kiraan fungsi SDK mereka. Jika jawapannya di bawah 18, anda sedang melihat pena log sahaja dalam samaran.
2. Profil Ketersambungan Merentas 11 Model
Ketersambungan menentukan seberapa pantas sesuatu peristiwa bergerak daripada pena ke aplikasi anda. Tiga radio yang paling relevan ialah Bluetooth, Wi-Fi, dan LTE pilihan.
| Model | BT | Wi-Fi | LTE | Segerak USB-C |
|---|---|---|---|---|
| B1 | Tiada | Tiada | Tiada | Ya |
| B2 | Tiada | Tiada | Tiada | Ya |
| F8 | Tiada | Tiada | Tiada | Ya |
| K7 | 4.2 | Tiada | Tiada | Ya |
| KF1 | 5.0 | Tiada | Tiada | Ya |
| L5 | 5.0 | 2.4 GHz | Tiada | Ya |
| P2 | 5.0 | Tiada | Tiada | Ya |
| Q6 | 5.0 | Tiada | Tiada | Ya |
| Q8 | 5.0 | 2.4/5 GHz | Tiada | Ya |
| T2 | 5.0 | 2.4/5 GHz | Tiada | Ya |
| Y6 | 5.0 | 2.4/5 GHz | Cat-1 pilihan | Ya |
P2, T2 dan Y6 ialah satu-satunya model yang menggabungkan Bluetooth 5.0 dengan permukaan strim acara yang terdokumenasi. T2 dan Y6 menambah Wi-Fi supaya pen boleh menghantar acara ke cloud secara terus tanpa melalui telefon. Modul LTE Cat-1 pilihan pada Y6 merupakan satu-satunya pilihan selular dalam barisan ini.
3. P2 — Integrasi Pihak Ketiga Bluetooth Sahaja
P2 menjalankan firmware 2.0.3. Ia menyambung ke aplikasi pihak ketiga secara eksklusif melalui Bluetooth 5.0. SDK mendedahkan 18 fungsi; 6 daripadanya merangkumi acara imbasan OID, iaitu apa yang diperlukan oleh aplikasi ibu bapa untuk menangkap "perkataan apakah yang diketik oleh anak". Bateri ialah 500 mAh dengan masa jalan 4.5 jam, dan berat ialah 38 g, menjadikan P2 pen bersepadukan pihak ketiga yang paling ringan dalam barisan kami.
Seni bina integrasi ialah pen → telefon → cloud. Pen memancarkan acara melalui BLE GATT; aplikasi telefon menerimanya dan meneruskannya ke cloud rakan kongsi. Kami menyokong pembalut iOS, Android dan React Native. Latensi hujung-ke-hujung median daripada ketukan pen ke cloud rakan kongsi ialah 280 ms.
P2 ialah pilihan tepat apabila aplikasi ibu bapa bersifat mobile-first dan keluarga memiliki telefon yang boleh menjadi jambatan. Ia bukan pilihan tepat untuk penggunaan di sekolah di mana Wi-Fi ialah saluran utama.
4. T2 — Integrasi Pihak Ketiga Asli Wi-Fi
T2 menjalankan firmware 2.6.4 pada Cortex-A53 quad-core dengan 16 GB flash. Ia menyambung ke aplikasi pihak ketiga melalui Bluetooth 5.0 dan melalui Wi-Fi 2.4/5 GHz. SDK mendedahkan 32 fungsi yang merangkumi imbasan OID, main balik audio, sesi Wi-Fi, sesi pengguna, OTA dan diagnostik. Bateri ialah 2,500 mAh Li-ion 18650 dengan masa jalan 14 jam.
Seni bina integrasi ialah pen → cloud → telefon. Acara meninggalkan pen melalui Wi-Fi, terus mencapai titik akhir REST rakan kongsi, dan aplikasi telefon menariknya atas permintaan. Latensi hujung-ke-hujung median menurun kepada 210 ms kerana telefon tidak lagi berada dalam laluan kritikal.
T2 ialah pilihan kuda kerja untuk penggunaan di sekolah. Armada 12,000 unit dalam rangkaian sekolah negara Teluk berjalan pada T2 kerana Wi-Fi tersedia di setiap bilik darjah dan bateri 14 jam meliputi sehari penuh K–8.
5. Y6 — Pilihan LTE untuk Wi-Fi yang Tidak Stabil
Y6 menjalankan firmware 2.6.4 pada platform yang sama seperti T2 tetapi menambah 32 GB flash, SDK penuh 42 fungsi, dan LTE Cat-1 pilihan. 7 jenis acara webhook adalah unik untuk Y6 dalam barisan ini. Bateri ialah 2,000 mAh dengan masa jalan 11 jam.
Seni bina integrasi pada Y6 ialah pen → cloud, sudah pasti. Sama ada laluan Wi-Fi, LTE atau geganti BLE, rakan kongsi melihat titik akhir REST yang seragam. Latensi hujung-ke-hujung median ialah 230 ms pada Wi-Fi dan 410 ms pada LTE, kedua-duanya jauh dalam SLA 2 saat yang kami terbitkan kepada rakan kongsi.
Y6 ialah pilihan flagship untuk penerbit yang mahukan persediaan tanpa konfigurasi — ibu bapa membuka kotak pen, mengimbas kod QR pada kotak, dan pen sudah dalam talian melalui selular sebelum keluarga mengkonfigurasi Wi-Fi.
6. Kontrak Data: 7 Jenis Acara
Ketiga-tiga model Tier 3 memancarkan 7 jenis acara webhook yang sama. Skema payload adalah identik merentasi P2, T2 dan Y6, yang bermakna rakan kongsi hanya perlu berintegrasi sekali dan boleh menukar perkakasan kemudian tanpa menulis semula pengendali acara.
| Acara | Saiz Payload | Pencetus | Kes Penggunaan Rakan Kongsi |
|---|---|---|---|
oid.scan |
0.4 KB | Pengguna mengetik perkataan | Analisis kosa kata |
session.start |
0.2 KB | Pengguna menghidupkan kuasa | Penjejakan penglibatan |
session.end |
0.2 KB | 5 min melahu | Analisis churn |
audio.play |
0.3 KB | Audio dimainkan | Penggunaan kandungan |
battery.low |
0.1 KB | Bateri ≤ 15% | Pemberitahuan armada |
firmware.update |
0.2 KB | OTA selesai | Jejak audit |
device.error |
0.4 KB | Ujian sendiri gagal | Penjejakan waranti |
Sesi bacaan 30 minit dengan pengetukan aktif menjana 220–340 acara. Acara imbasan 0.4 KB ialah muatan isipadu tertinggi dan merupakan yang mendorong perbualan had kadar dengan rakan kongsi.
7. Permukaan OAuth 2.0 dan Webhook
Penyepaduan aplikasi pihak ketiga disahkan melalui kelayakan klien OAuth 2.0. Setiap rakan kongsi menerima ID klien dan rahsia klien semasa onboarding, serta skop rakan kongsi yang mengehadkan titik akhir dan SKU yang boleh mereka akses. Titik akhir token mengembalikan token akses JWT dengan tamat tempoh 1 jam. Kami mengesyorkan supaya cache token selama 55 minit dan dikeluarkan semula pada minit ke-56 untuk mengelakkan permintaan dalam penerbangan daripada gagal.
Penghantaran Webhook membuat semula dengan backoff eksponen pada 1, 5, 30, 120, dan 600 saat. Masa penghantaran persentil ke-99 merentasi 142 penyepaduan pengeluaran ialah 2.1 saat.
8. Pembungkus iOS, Android, dan React Native
SDK pada peranti dihantar sebagai perpustakaan statik C/C++. Di atas itu, kami menghantar pembungkus asli untuk iOS (Swift 5.9+), Android (Kotlin 1.9+), dan React Native (0.73+). Muatan pembungkus ialah 240 KB dimampatkan. Rakan kongsi biasanya melihat lonjakan 3–5 hari untuk memasang pembungkus ke dalam aplikasi sedia ada dan tambahan 4–6 hari untuk menguji kes tepi.
| Platform | Pembungkus | Versi Min | Muatan |
|---|---|---|---|
| iOS | Swift Package | iOS 15 | 220 KB |
| Android | AAR | API 24 | 240 KB |
| React Native | Turbo Module | RN 0.73 | 260 KB |
| Flutter | Plugin | Flutter 3.16 | 280 KB |
Sokongan Flutter ditambah dalam firmware 2.6.4. Pelepasan firmware yang lebih lama hanya merangkumi Swift dan Kotlin.
9. Harga, MOQ, dan Masa Pendahuluan
Harga untuk tiga model Tier 3 dipautkan pada tier SDK dan kuantiti pesanan. Jadual di bawah menunjukkan harga rujukan Q3-2026 kami.
| Model | MOQ | Harga FOB (500-unit) | Harga FOB (5,000-unit) | Masa Pendahuluan |
|---|---|---|---|---|
| P2 | 500 | $11.20 | $9.40 | 25 hari |
| T2 | 500 | $13.80 | $11.50 | 28 hari |
| Y6 | 500 | $14.50 | $12.20 | 30 hari |
Ketiga-tiganya termasuk pemalsuan SDK, akses ke API REST terukan dan pakej wrapper tanpa pembahayaan tambahan. Tampaknya ia perlu diubah suai dan tidak dikurangkan.
10. Senarai Semakan QA untuk Integrasi Aplikasi Pihak Ketiga
Integrasi aplikasi pihak ketiga yang bersih melalui 14 langkah pengesahan. Kami memerlukan kesemua 14 ditandatangani sebelum pengeluaran 5,000 unit dibenarkan.
| # | Semakan | Kriteria Lulus |
|---|---|---|
| 1 | Sambungan BLE GATT | Stabil dalam 1.8 s |
| 2 | Persatuan Wi-Fi | Sambung semula dalam 4.5 s |
| 3 | Pengeluaran token OAuth | 200 OK dalam 200 ms |
| 4 | Penghantaran acara imbasan OID | 280 ms median hujung-ke-hujung |
| 5 | Kawalan main balik audio | Latensi bawah 60 ms |
| 6 | Mula/akhir sesi | Kedua-dua acara dalam 100 ms pencetus |
| 7 | Telemetri bateri | Kemas kini setiap 5 min |
| 8 | Saluran OTA | Muatan 2.4 MB dalam bawah 90 s |
| 9 | Tandatangan Webhook | HMAC-SHA256 disahkan |
| 10 | Dasar cuba semula | 5 cubaan dengan backoff |
| 11 | Pengendalian had kadar | 429 dengan Retry-After |
| 12 | Redaksi PII | Tiada nama kanak-kanak dalam URL |
| 13 | Persetujuan COPPA / GDPR | Sepanduk dikuatkuasakan |
| 14 | Kembalikan firmware | Kembali dalam bawah 60 s |
Langkah 1–8 merangkumi UX langsung. Langkah 9–11 merangkumi kontrak API. Langkah 12–14 merangkumi lapisan pematuhan dan kebolehpercayaan. Mana-mana yang terlepas menjadi penghalang pelancaran.
10. Matriks Perbandingan Model Merentasi Tahap Integrasi
Jadual di bawah menggabungkan 11 model merentasi tiga tahap integrasi. Gunakan ini sebagai rujukan satu halaman semasa mengurus RFP aplikasi pihak ketiga.
| Model | Tahap | BT | Wi-Fi | Fungsi SDK | Bateri | FOB (5k unit) | Kes Penggunaan Aplikasi |
|---|---|---|---|---|---|---|---|
| B1 | Tiada | Tidak | Tidak | 0 | 700 mAh / 5.0 j | $4.10 | Runcit tertutup |
| B2 | Tiada | Tidak | Tidak | 0 | 800 mAh / 5.5 j | $4.60 | Runcit tertutup |
| F8 | Log | Tidak | Tidak | 0 | 600 mAh / 4.5 j | $6.80 | Pengaliran log luar talian |
| K7 | Log | 4.2 | Tidak | 0 | 800 mAh / 6.0 j | $7.20 | Log pemula |
| KF1 | Log | 5.0 | Tidak | 0 | 800 mAh / 6.0 j | $7.60 | Log pemula, BT |
| L5 | Separa | 5.0 | 2.4 | 14 | 1,200 mAh / 8.5 j | $10.40 | Separa premium |
| P2 | Penuh | 5.0 | Tidak | 18 | 500 mAh / 4.0 j | $9.40 | Mobile-bridge OEM |
| Q6 | Log | 5.0 | No | 0 | 900 mAh / 6.5 j | $9.20 | Mid-market log |
| Q8 | Separa | 5.0 | 2.4/5 | 18 | 1,000 mAh / 7.0 j | $12.80 | Premium separa |
| T2 | Penuh | 5.0 | 2.4/5 | 32 | 2,500 mAh / 14 j | $11.50 | School OEM |
| Y6 | Penuh | 5.0 | 2.4/5 + LTE | 42 | 2,000 mAh / 11 jam | $12.20 | OEM Andalan |
Untuk aplikasi induk jambatan mudah alih pada 5,000 unit, campuran lazim ialah 45 persen P2 (kuda kerja Bluetooth sahaja) ditambah 35 persen T2 ditambah 20 persen Y6. Untuk program bawa pulang 1:1, campuran lazimnya menjadi 60 persen Y6 ditambah 30 persen T2 ditambah 10 persen P2.
11. Jejak Penggunaan Lapangan mengikut Wilayah
Jejak integrasi aplikasi pihak ketiga berubah dengan ketara mengikut wilayah. Penggunaan di EU dan negara Teluk hampir keseluruhannya menggunakan T2 kerana Wi-Fi bilik darjah yang stabil. Penggunaan di Amerika Utara lebih banyak menggunakan P2 kerana ibu bapa lebih memilih jambatan telefon.
| Wilayah | Bahagian P2 | Bahagian T2 | Bahagian Y6 |
|---|---|---|---|
| Amerika Utara | 45% | 35% | 20% |
| EU + UK | 15% | 70% | 15% |
| Negara-negara Teluk | 10% | 60% | 30% |
| Asia Tenggara | 35% | 50% | 15% |
| Amerika Latin | 50% | 35% | 15% |
| Afrika | 30% | 50% | 20% |
Merentasi 142 integrasi pengeluaran yang telah kami hantar, campuran wilayah di atas adalah purata; daerah tertentu boleh berubah sebanyak ±15 mata peratusan.
12. Senarai Semakan Keputusan Sebelum Menandatangani PO Integrasi Aplikasi
- Bilangan fungsi SDK yang disahkan ≥ 18 (tier penuh)
- Wi-Fi 2.4/5 GHz pada papan disahkan (T2 / Y6)
- Percubaan dijalankan selama ≥ 14 hari dengan sekurang-kurangnya 50 pen
- Tandatangan Webhook HMAC-SHA256 dikuatkuasakan
- Skrin persetujuan OAuth disemak oleh peguam rakan kongsi
- Bajet had kadar dikira terhadap volum acara
- Sepanduk persetujuan COPPA / GDPR / LGPD dikuatkuasakan
- Kolam alat ganti (3% daripada pesanan) dijanjikan secara bertulis
- Laluan naik taraf firmware Tahun-2 dijanjikan secara bertulis