โหมดอุปกรณ์เสริม USB ช่วยให้ผู้ใช้เชื่อมต่อฮาร์ดแวร์โฮสต์ USB ที่ออกแบบมาสำหรับอุปกรณ์ที่ทำงานด้วยระบบ Android โดยเฉพาะได้ อุปกรณ์เสริมต้องเป็นไปตามโปรโตคอลอุปกรณ์เสริม Android ที่ระบุไว้ในเอกสารประกอบของ Android Accessory Development Kit ซึ่งช่วยให้อุปกรณ์ที่ทำงานด้วยระบบ Android ที่ไม่สามารถทำหน้าที่เป็นโฮสต์ USB ยังคงโต้ตอบกับฮาร์ดแวร์ USB ได้ เมื่ออุปกรณ์ที่ทำงานด้วยระบบ Android อยู่ในโหมดอุปกรณ์เสริม USB อุปกรณ์เสริม USB ของ Android ที่เชื่อมต่ออยู่จะทำหน้าที่เป็นโฮสต์ จ่ายไฟให้กับบัส USB และแจกแจงอุปกรณ์ที่เชื่อมต่อ Android 3.1 (ระดับ API 12) รองรับโหมดอุปกรณ์เสริม USB และฟีเจอร์นี้ยังได้รับการพอร์ตไปยัง Android 2.3.4 (ระดับ API 10) เพื่อรองรับอุปกรณ์ที่หลากหลายมากขึ้นด้วย
เลือก API อุปกรณ์เสริม USB ที่เหมาะสม
แม้ว่า API อุปกรณ์เสริม USB จะเปิดตัวในแพลตฟอร์ม Android 3.1 แต่ก็พร้อมใช้งานใน Android 2.3.4 โดยใช้ไลบรารีส่วนเสริม Google APIs ด้วย เนื่องจาก API เหล่านี้ได้รับการพอร์ตย้อนกลับโดยใช้ไลบรารีภายนอก จึงมีแพ็กเกจ 2 รายการที่คุณสามารถนำเข้าเพื่อรองรับโหมดอุปกรณ์เสริม USB คุณอาจต้องใช้เครื่องมืออย่างใดอย่างหนึ่ง ทั้งนี้ขึ้นอยู่กับอุปกรณ์ที่ทำงานด้วยระบบ Android ที่คุณต้องการรองรับ
com.android.future.usb: เพื่อรองรับโหมดอุปกรณ์เสริม USB ใน Android 2.3.4 ไลบรารีส่วนเสริม Google APIs จึงมี API อุปกรณ์เสริม USB ที่พอร์ตย้อนหลังและอยู่ในเนมสเปซนี้ Android 3.1 ยังรองรับการนำเข้าและการเรียกใช้คลาสภายในเนมสเปซนี้เพื่อรองรับแอปพลิเคชันที่เขียนด้วยไลบรารีส่วนเสริม ไลบรารีส่วนเสริมนี้เป็น Wrapper แบบบางที่ครอบ API อุปกรณ์เสริมandroid.hardware.usbและไม่รองรับโหมดโฮสต์ USBหากต้องการรองรับอุปกรณ์ที่หลากหลายที่สุดที่รองรับโหมดอุปกรณ์เสริม USB ให้ใช้ไลบรารีส่วนเสริมและนำเข้าแพ็กเกจนี้ โปรดทราบว่าอุปกรณ์ Android 2.3.4 บางรุ่นอาจไม่จำเป็นต้องรองรับฟีเจอร์อุปกรณ์เสริม USB ผู้ผลิตอุปกรณ์แต่ละรายจะตัดสินใจว่าจะรองรับความสามารถนี้หรือไม่ คุณจึงต้องประกาศความสามารถนี้ในไฟล์ Manifest
android.hardware.usb: เนมสเปซนี้มีคลาสที่รองรับโหมดอุปกรณ์เสริม USB ใน Android 3.1 แพ็กเกจนี้รวมอยู่ใน API ของเฟรมเวิร์ก ดังนั้น Android 3.1 จึงรองรับโหมดอุปกรณ์เสริม USB โดยไม่ต้องใช้ไลบรารีเสริม ใช้แพ็กเกจนี้หากคุณสนใจเฉพาะอุปกรณ์ Android 3.1 ขึ้นไปที่มีการรองรับฮาร์ดแวร์สำหรับโหมดอุปกรณ์เสริม USB ซึ่งคุณประกาศได้ในไฟล์ Manifest
ติดตั้งไลบรารีส่วนเสริม Google APIs
หากต้องการติดตั้งส่วนเสริม คุณสามารถติดตั้งแพ็กเกจ Google APIs Android API 10 ด้วยเครื่องมือจัดการ SDK ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งไลบรารีส่วนเสริมได้ที่การติดตั้งส่วนเสริม Google APIs
ภาพรวม API
เนื่องจากไลบรารีส่วนเสริมเป็น Wrapper สำหรับ API ของเฟรมเวิร์ก คลาสที่รองรับฟีเจอร์อุปกรณ์เสริม USB จึงคล้ายกัน คุณสามารถใช้เอกสารอ้างอิงสำหรับ android.hardware.usb ได้แม้ว่าจะใช้ไลบรารีส่วนเสริมอยู่ก็ตาม
หมายเหตุ: อย่างไรก็ตาม มีความแตกต่างในการใช้งานเล็กน้อยระหว่างไลบรารีส่วนเสริมกับ API ของเฟรมเวิร์กที่คุณควรทราบ
ตารางต่อไปนี้อธิบายคลาสที่รองรับ API อุปกรณ์เสริม USB
| ชั้น | คำอธิบาย |
|---|---|
UsbManager |
ช่วยให้คุณแจกแจงและสื่อสารกับอุปกรณ์เสริม USB ที่เชื่อมต่ออยู่ได้ |
UsbAccessory |
แสดงถึงอุปกรณ์เสริม USB และมีวิธีการเข้าถึงข้อมูลระบุตัวตนของอุปกรณ์เสริม |
ความแตกต่างในการใช้งานระหว่างไลบรารีส่วนเสริมและ API ของแพลตฟอร์ม
การใช้ไลบรารีส่วนเสริม Google APIs และ API ของแพลตฟอร์มมีความแตกต่างกัน 2 ประการ ดังนี้
หากใช้ไลบรารีส่วนเสริม คุณต้องรับออบเจ็กต์ UsbManager ด้วยวิธีต่อไปนี้
Kotlin
val manager = UsbManager.getInstance(this)
Java
UsbManager manager = UsbManager.getInstance(this);
หากไม่ได้ใช้ไลบรารีส่วนเสริม คุณต้องรับออบเจ็กต์ UsbManager ในลักษณะต่อไปนี้
Kotlin
val manager = getSystemService(Context.USB_SERVICE) as UsbManager
Java
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
เมื่อคุณกรองหาอุปกรณ์เสริมที่เชื่อมต่อด้วยตัวกรอง Intent ออบเจ็กต์ UsbAccessory จะอยู่ภายใน Intent ที่ส่งไปยังแอปพลิเคชันของคุณ หากใช้ไลบรารีส่วนเสริม คุณต้องรับออบเจ็กต์ UsbAccessory ด้วยวิธีต่อไปนี้
Kotlin
val accessory = UsbManager.getAccessory(intent)
Java
UsbAccessory accessory = UsbManager.getAccessory(intent);
หากไม่ได้ใช้ไลบรารีส่วนเสริม คุณต้องรับออบเจ็กต์ UsbAccessory ในลักษณะต่อไปนี้
Kotlin
val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory
Java
UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);
ข้อกำหนดของไฟล์ Manifest ของ Android
รายการต่อไปนี้อธิบายสิ่งที่คุณต้องเพิ่มลงในไฟล์ Manifest ของแอปพลิเคชันก่อนที่จะทำงานกับ API อุปกรณ์เสริม USB ตัวอย่างไฟล์ Manifest และไฟล์ทรัพยากรแสดงวิธีประกาศรายการเหล่านี้
- เนื่องจากอุปกรณ์ที่ทำงานด้วยระบบ Android บางรุ่นอาจไม่รองรับ API อุปกรณ์เสริม USB ให้ใส่เอลิเมนต์
<uses-feature>ที่ประกาศว่าแอปพลิเคชันของคุณใช้ฟีเจอร์android.hardware.usb.accessory - หากใช้ไลบรารีส่วนเสริม ให้เพิ่มองค์ประกอบ
<uses-library>ที่ระบุcom.android.future.usb.accessoryสำหรับไลบรารี - ตั้งค่า SDK ขั้นต่ำของแอปพลิเคชันเป็นระดับ API 10 หากคุณใช้ไลบรารีส่วนเสริม หรือระดับ 12 หากคุณใช้แพ็กเกจ
android.hardware.usb -
หากต้องการให้แอปพลิเคชันได้รับการแจ้งเตือนเกี่ยวกับอุปกรณ์เสริม USB ที่เชื่อมต่ออยู่ ให้ระบุคู่องค์ประกอบ
<intent-filter>และ<meta-data>สำหรับ Intentandroid.hardware.usb.action.USB_ACCESSORY_ATTACHEDในกิจกรรมหลัก องค์ประกอบ<meta-data>ชี้ไปยังไฟล์ทรัพยากร XML ภายนอกที่ประกาศข้อมูลระบุตัวตนเกี่ยวกับอุปกรณ์เสริมที่คุณต้องการตรวจจับในไฟล์ทรัพยากร XML ให้ประกาศองค์ประกอบ
<usb-accessory>สำหรับอุปกรณ์เสริมที่ต้องการกรอง<usb-accessory>แต่ละรายการมีแอตทริบิวต์ต่อไปนี้ได้manufacturermodelversion
ไม่แนะนำให้กรอง
versionอุปกรณ์เสริมหรืออุปกรณ์อาจไม่ได้ระบุสตริงเวอร์ชันเสมอไป (โดยตั้งใจหรือไม่ตั้งใจ) เมื่อแอปประกาศแอตทริบิวต์เวอร์ชันเพื่อกรอง และอุปกรณ์เสริมหรืออุปกรณ์ไม่ได้ระบุสตริงเวอร์ชัน จะทำให้เกิดNullPointerExceptionใน Android เวอร์ชันก่อนหน้า ปัญหานี้ได้รับการแก้ไขแล้วใน Android 12บันทึกไฟล์ทรัพยากรในไดเรกทอรี
res/xml/ชื่อไฟล์ทรัพยากร (ไม่มีนามสกุล .xml) ต้องเหมือนกับชื่อที่คุณระบุในองค์ประกอบ<meta-data>รูปแบบของไฟล์ทรัพยากร XML จะแสดงในตัวอย่างต่อไปนี้ด้วย
ตัวอย่างไฟล์ Manifest และไฟล์ทรัพยากร
ตัวอย่างต่อไปนี้แสดงไฟล์ Manifest ตัวอย่างและไฟล์ทรัพยากรที่เกี่ยวข้อง
<manifest ...> <uses-feature android:name="android.hardware.usb.accessory" /> <uses-sdk android:minSdkVersion="<version>" /> ... <application> <uses-library android:name="com.android.future.usb.accessory" /> <activity ...> ... <intent-filter> <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" /> </intent-filter> <meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" android:resource="@xml/accessory_filter" /> </activity> </application> </manifest>
ในกรณีนี้ ควรบันทึกไฟล์ทรัพยากรต่อไปนี้ใน res/xml/accessory_filter.xml และระบุว่าควรกรองอุปกรณ์เสริมที่มีรุ่น ผู้ผลิต และเวอร์ชันที่เกี่ยวข้องออก อุปกรณ์เสริมจะส่งแอตทริบิวต์เหล่านี้ไปยังอุปกรณ์ที่ใช้ Android
<?xml version="1.0" encoding="utf-8"?> <resources> <usb-accessory model="DemoKit" manufacturer="Google" version="1.0"/> </resources>
ใช้งานร่วมกับอุปกรณ์เสริม
เมื่อผู้ใช้เชื่อมต่ออุปกรณ์เสริม USB กับอุปกรณ์ที่ทำงานด้วยระบบ Android ระบบ Android จะระบุได้ว่าแอปพลิเคชันของคุณสนใจอุปกรณ์เสริมที่เชื่อมต่ออยู่หรือไม่ หากเป็นเช่นนั้น คุณจะตั้งค่าการสื่อสารกับอุปกรณ์เสริมได้หากต้องการ ซึ่งแอปพลิเคชันของคุณต้องทำดังนี้
- ค้นหาอุปกรณ์เสริมที่เชื่อมต่อโดยใช้ตัวกรอง Intent ที่กรองเหตุการณ์ที่แนบอุปกรณ์เสริมหรือโดยการแจกแจงอุปกรณ์เสริมที่เชื่อมต่อและค้นหาอุปกรณ์เสริมที่เหมาะสม
- ขอสิทธิ์จากผู้ใช้เพื่อสื่อสารกับอุปกรณ์เสริม หากยังไม่ได้รับสิทธิ์
- สื่อสารกับอุปกรณ์เสริมโดยการอ่านและเขียนข้อมูลบนปลายทางอินเทอร์เฟซที่เหมาะสม
ค้นหาอุปกรณ์เสริม
แอปพลิเคชันของคุณสามารถค้นหาอุปกรณ์เสริมได้โดยใช้ตัวกรอง Intent เพื่อรับการแจ้งเตือนเมื่อผู้ใช้เชื่อมต่ออุปกรณ์เสริมหรือโดยการแจกแจงอุปกรณ์เสริมที่เชื่อมต่ออยู่แล้ว การใช้ตัวกรอง Intent จะมีประโยชน์หากคุณต้องการให้แอปพลิเคชันตรวจหาอุปกรณ์เสริมที่ต้องการโดยอัตโนมัติ การแจกแจงอุปกรณ์เสริมที่เชื่อมต่อจะมีประโยชน์หากคุณต้องการดูรายการอุปกรณ์เสริมที่เชื่อมต่อทั้งหมด หรือหากแอปพลิเคชันไม่ได้กรอง Intent
ใช้ตัวกรอง Intent
หากต้องการให้แอปพลิเคชันค้นพบอุปกรณ์เสริม USB ที่เฉพาะเจาะจง คุณสามารถระบุตัวกรอง Intent เพื่อกรอง Intent android.hardware.usb.action.USB_ACCESSORY_ATTACHED ได้ นอกจากตัวกรอง Intent นี้แล้ว คุณต้องระบุไฟล์ทรัพยากรที่ระบุพร็อพเพอร์ตี้ของอุปกรณ์เสริม USB เช่น ผู้ผลิต รุ่น และเวอร์ชัน
ตัวอย่างต่อไปนี้แสดงวิธีประกาศตัวกรอง Intent
<activity ...> ... <intent-filter> <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" /> </intent-filter> <meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" android:resource="@xml/accessory_filter" /> </activity>
ตัวอย่างต่อไปนี้แสดงวิธีประกาศไฟล์ทรัพยากรที่เกี่ยวข้องซึ่งระบุอุปกรณ์เสริม USB ที่คุณสนใจ
<?xml version="1.0" encoding="utf-8"?> <resources> <usb-accessory manufacturer="Google, Inc." model="DemoKit" version="1.0" /> </resources>
ในกิจกรรม คุณสามารถรับ UsbAccessory ที่แสดงถึงอุปกรณ์เสริมที่เชื่อมต่อจาก Intent ได้ดังนี้ (พร้อมไลบรารีส่วนเสริม)
Kotlin
val accessory = UsbManager.getAccessory(intent)
Java
UsbAccessory accessory = UsbManager.getAccessory(intent);
หรือแบบนี้ (ด้วย API ของแพลตฟอร์ม)
Kotlin
val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory
Java
UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);
แจกแจงอุปกรณ์เสริม
คุณสามารถให้แอปพลิเคชันแจกแจงอุปกรณ์เสริมที่ระบุตัวตนขณะที่แอปพลิเคชันทำงานอยู่ได้
ใช้เมธอด getAccessoryList() เพื่อรับอาร์เรย์ของอุปกรณ์เสริม USB ทั้งหมดที่เชื่อมต่ออยู่
Kotlin
val manager = getSystemService(Context.USB_SERVICE) as UsbManager val accessoryList: Array<out UsbAccessory> = manager.accessoryList
Java
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE); UsbAccessory[] accessoryList = manager.getAccessoryList();
หมายเหตุ: ระบบรองรับอุปกรณ์เสริมที่เชื่อมต่อได้ครั้งละ 1 รายการเท่านั้น
ขอสิทธิ์ในการสื่อสารกับอุปกรณ์เสริม
ก่อนที่จะสื่อสารกับอุปกรณ์เสริม USB แอปพลิเคชันของคุณต้องได้รับสิทธิ์จากผู้ใช้
หมายเหตุ: หากแอปพลิเคชันใช้ตัวกรอง Intent เพื่อค้นหาอุปกรณ์เสริมเมื่อเชื่อมต่อ แอปพลิเคชันจะได้รับสิทธิ์โดยอัตโนมัติหากผู้ใช้อนุญาตให้แอปพลิเคชันจัดการ Intent หากไม่ คุณต้องขอสิทธิ์อย่างชัดแจ้งในแอปพลิเคชันก่อนเชื่อมต่อกับอุปกรณ์เสริม
การขอสิทธิ์อย่างชัดแจ้งอาจจำเป็นในบางสถานการณ์ เช่น เมื่อแอปพลิเคชันแจกแจงอุปกรณ์เสริมที่เชื่อมต่ออยู่แล้วและต้องการสื่อสารกับอุปกรณ์เสริมดังกล่าว คุณต้องตรวจสอบสิทธิ์ในการเข้าถึงอุปกรณ์เสริมก่อนที่จะพยายามสื่อสารกับอุปกรณ์เสริมนั้น หากไม่ คุณจะได้รับข้อผิดพลาดขณะรันไทม์หากผู้ใช้ปฏิเสธสิทธิ์เข้าถึงอุปกรณ์เสริม
หากต้องการขอสิทธิ์อย่างชัดแจ้ง ให้สร้าง Broadcast Receiver ก่อน BroadcastReceiver นี้จะคอยฟัง Intent ที่มีการประกาศเมื่อคุณเรียกใช้ requestPermission() การเรียกใช้ requestPermission() จะแสดงกล่องโต้ตอบแก่ผู้ใช้เพื่อขอสิทธิ์เชื่อมต่อกับอุปกรณ์เสริม โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้าง Broadcast Receiver
Kotlin
private const val ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION" private val usbReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (ACTION_USB_PERMISSION == intent.action) { synchronized(this) { val accessory: UsbAccessory? = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) { accessory?.apply { // call method to set up accessory communication } } else { Log.d(TAG, "permission denied for accessory $accessory") } } } } }
Java
private static final String ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION"; private final BroadcastReceiver usbReceiver = new BroadcastReceiver() { public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (ACTION_USB_PERMISSION.equals(action)) { synchronized (this) { UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY); if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) { if(accessory != null){ // call method to set up accessory communication } } else { Log.d(TAG, "permission denied for accessory " + accessory); } } } } };
หากต้องการลงทะเบียน Broadcast Receiver ให้ใส่โค้ดนี้ในเมธอด onCreate() ในกิจกรรม
Kotlin
private const val ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION" ... val manager = getSystemService(Context.USB_SERVICE) as UsbManager ... permissionIntent = PendingIntent.getBroadcast(this, 0, Intent(ACTION_USB_PERMISSION), 0) val filter = IntentFilter(ACTION_USB_PERMISSION) registerReceiver(usbReceiver, filter)
Java
UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE); private static final String ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION"; ... permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0); IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION); registerReceiver(usbReceiver, filter);
หากต้องการแสดงกล่องโต้ตอบที่ขอสิทธิ์จากผู้ใช้ในการเชื่อมต่อกับอุปกรณ์เสริม ให้เรียกใช้เมธอด requestPermission() ดังนี้
Kotlin
lateinit var accessory: UsbAccessory ... usbManager.requestPermission(accessory, permissionIntent)
Java
UsbAccessory accessory; ... usbManager.requestPermission(accessory, permissionIntent);
เมื่อผู้ใช้ตอบกลับกล่องโต้ตอบ Broadcast Receiver จะได้รับ Intent ที่มี EXTRA_PERMISSION_GRANTED เพิ่มเติม ซึ่งเป็นบูลีนที่แสดงคำตอบ ตรวจสอบส่วนเสริมนี้เพื่อหาค่า "จริง" ก่อนเชื่อมต่อกับอุปกรณ์เสริม
สื่อสารกับอุปกรณ์เสริม
คุณสามารถสื่อสารกับอุปกรณ์เสริมได้โดยใช้ UsbManager เพื่อรับตัวบอกไฟล์ที่สามารถตั้งค่าสตรีมอินพุตและเอาต์พุตเพื่ออ่านและเขียนข้อมูลลงในตัวบอกไฟล์ได้ สตรีมแสดงถึงปลายทางแบบกลุ่มของอินพุตและเอาต์พุตของอุปกรณ์เสริม คุณควรตั้งค่าการสื่อสารระหว่างอุปกรณ์และอุปกรณ์เสริมในอีกเทรดหนึ่ง เพื่อไม่ให้ล็อกเทรด UI หลัก ตัวอย่างต่อไปนี้แสดงวิธีเปิดอุปกรณ์เสริมเพื่อสื่อสารด้วย
Kotlin
private lateinit var accessory: UsbAccessory private var fileDescriptor: ParcelFileDescriptor? = null private var inputStream: FileInputStream? = null private var outputStream: FileOutputStream? = null ... private fun openAccessory() { Log.d(TAG, "openAccessory: $mAccessory") fileDescriptor = usbManager.openAccessory(accessory) fileDescriptor?.fileDescriptor?.also { fd -> inputStream = FileInputStream(fd) outputStream = FileOutputStream(fd) val thread = Thread(null, this, "AccessoryThread") thread.start() } }
Java
UsbAccessory accessory; ParcelFileDescriptor fileDescriptor; FileInputStream inputStream; FileOutputStream outputStream; ... private void openAccessory() { Log.d(TAG, "openAccessory: " + accessory); fileDescriptor = usbManager.openAccessory(accessory); if (fileDescriptor != null) { FileDescriptor fd = fileDescriptor.getFileDescriptor(); inputStream = new FileInputStream(fd); outputStream = new FileOutputStream(fd); Thread thread = new Thread(null, this, "AccessoryThread"); thread.start(); } }
ในเมธอด run() ของชุดข้อความ คุณสามารถอ่านและเขียนไปยังอุปกรณ์เสริมได้โดยใช้ออบเจ็กต์ FileInputStream หรือ FileOutputStream เมื่ออ่านข้อมูลจากอุปกรณ์เสริมที่มีออบเจ็กต์ FileInputStream ให้ตรวจสอบว่าบัฟเฟอร์ที่คุณใช้มีขนาดใหญ่พอที่จะจัดเก็บข้อมูลแพ็กเก็ต USB โปรโตคอลอุปกรณ์เสริม Android รองรับบัฟเฟอร์แพ็กเก็ตสูงสุด 16, 384 ไบต์ คุณจึงเลือกประกาศบัฟเฟอร์ให้มีขนาดเท่านี้เสมอได้เพื่อความสะดวก
หมายเหตุ: ในระดับที่ต่ำกว่า แพ็กเก็ตจะมีขนาด 64 ไบต์สำหรับอุปกรณ์เสริม USB ความเร็วเต็ม และ 512 ไบต์สำหรับอุปกรณ์เสริม USB ความเร็วสูง โปรโตคอลอุปกรณ์เสริม Android จะรวมแพ็กเก็ตสำหรับทั้ง 2 ความเร็วเข้าด้วยกันเป็นแพ็กเก็ตเชิงตรรกะเดียวเพื่อความเรียบง่าย
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เทรดใน Android ได้ที่กระบวนการและเทรด
สิ้นสุดการสื่อสารกับอุปกรณ์เสริม
เมื่อสื่อสารกับอุปกรณ์เสริมเสร็จแล้วหรือหากถอดอุปกรณ์เสริมออก ให้ปิดตัวบอกไฟล์ที่คุณเปิดโดยเรียกใช้ close()
หากต้องการฟังเหตุการณ์ที่แยกออก ให้สร้าง Broadcast Receiver ดังนี้
Kotlin
var usbReceiver: BroadcastReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (UsbManager.ACTION_USB_ACCESSORY_DETACHED == intent.action) { val accessory: UsbAccessory? = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) accessory?.apply { // call your method that cleans up and closes communication with the accessory } } } }
Java
BroadcastReceiver usbReceiver = new BroadcastReceiver() { public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (UsbManager.ACTION_USB_ACCESSORY_DETACHED.equals(action)) { UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY); if (accessory != null) { // call your method that cleans up and closes communication with the accessory } } } };
การสร้าง Broadcast Receiver ภายในแอปพลิเคชัน ไม่ใช่ไฟล์ Manifest จะช่วยให้แอปพลิเคชันของคุณจัดการเฉพาะเหตุการณ์ที่แยกออกขณะที่แอปพลิเคชันทำงานอยู่ ด้วยวิธีนี้ ระบบจะส่งเหตุการณ์ที่แยกออกไปยังแอปพลิเคชันที่กำลังทำงานอยู่เท่านั้น และจะไม่เผยแพร่ไปยังแอปพลิเคชันทั้งหมด