이 페이지는 Cloud Translation API를 통해 번역되었습니다.

USB 액세서리 개요

USB 액세서리 모드를 사용하면 Android 지원 기기용으로 특별히 설계된 USB 호스트 하드웨어입니다. 액세서리는 다음 사항을 준수해야 합니다. Android 액세서리 개발 키트 문서에 설명된 Android 액세서리 프로토콜로 대체합니다. 이렇게 하면 USB 호스트 역할을 할 수 없는 Android 지원 기기가 여전히 USB와 상호작용할 수 있습니다. 사용할 수 있습니다 Android 지원 기기가 USB 액세서리 모드일 때 연결된 Android USB는 액세서리는 호스트 역할을 하고, USB 버스에 전원을 공급하고, 연결된 기기를 열거합니다. Android 3.1 (API 수준 12)은 USB 액세서리 모드를 지원하며 이 기능도 Android 2.3.4 (API 수준 10)를 통해 더 광범위한 기기를 지원할 수 있습니다.

적절한 USB 액세서리 API 선택

USB 액세서리 API는 Android 3.1에서 플랫폼에 도입되었지만, API 추가 기능 라이브러리를 사용하여 Android 2.3.4에서 사용할 수 있습니다. 이러한 API는 외부 라이브러리를 사용하여 백포팅된 경우 USB를 지원하기 위해 가져올 수 있는 두 가지 패키지가 있습니다. 액세서리 모드로 전환하세요. 지원하려는 Android 기기에 따라 둘 중 하나를 사용합니다.

com.android.future.usb: Android 2.3.4에서 USB 액세서리 모드를 지원하기 위해 Google API 추가 기능 라이브러리에는 백포트된 USB 액세서리 API가 포함되어 있으며 이 API는 네임스페이스입니다. Android 3.1은 또한 이 네임스페이스 내에서 클래스를 가져오고 호출하여 부가기능 라이브러리로 작성된 애플리케이션 지원 이 부가기능 라이브러리는 얇은 래퍼입니다. android.hardware.usb 액세서리 API 주변에서 작동하며 USB 호스트 모드를 지원하지 않습니다. 만약 USB 액세서리 모드를 지원하는 다양한 기기를 지원하려면 이 패키지를 가져옵니다. 모든 Android 2.3.4 기기가 USB 액세서리 기능을 지원하는 데 필요합니다. 개별 기기 제조업체에서 결정 이 기능을 지원할지 여부를 지정합니다. 따라서 매니페스트에서 이 기능을 선언해야 합니다. 파일에서 참조됩니다.
android.hardware.usb: 이 네임스페이스에는 USB를 지원하는 클래스가 포함되어 있습니다. 액세서리 모드로 전환할 수 있습니다. 이 패키지는 프레임워크 API의 일부로 포함되므로 Android 3.1은 부가기능 라이브러리를 사용하지 않고도 USB 액세서리 모드를 지원합니다. 이 패키지 사용 USB를 지원하는 하드웨어가 있는 Android 3.1 이상의 기기에만 관심이 있는 경우 액세서리 모드에서 이 기능을 사용할 수 있습니다. 이는 매니페스트 파일에서 선언할 수 있습니다.

Google API 부가기능 라이브러리 설치

부가기능을 설치하려면 Google API Android API 10 설치해야 합니다 Google API 설치 부가기능을 참고하세요.

API 개요

부가기능 라이브러리는 프레임워크 API의 래퍼이므로 USB 액세서리 기능은 비슷합니다. 부가기능 라이브러리를 사용하더라도 android.hardware.usb의 참조 문서를 사용할 수 있습니다.

참고: 하지만 약간의 사용량은 있습니다. 부가기능 라이브러리와 프레임워크 API의 차이점을 알아보세요.

다음 표에서는 USB 액세서리 API를 지원하는 클래스를 설명합니다.

클래스	설명
`UsbManager`	이 클래스를 사용하면 연결된 USB 액세서리를 열거하고 액세서리와 통신할 수 있습니다.
`UsbAccessory`	USB 액세서리를 나타내며 식별에 액세스하는 데 사용되는 메서드를 포함합니다. 확인할 수 있습니다

부가기능 라이브러리와 플랫폼 API의 사용법 차이

Google API 부가기능 라이브러리와 플랫폼 사용법에는 두 가지 차이점이 있습니다. API에 액세스할 수 있습니다

부가기능 라이브러리를 사용한다면 다음과 같은 방식으로 UsbManager 객체를 얻어야 합니다.

Kotlin

val manager = UsbManager.getInstance(this)

자바

UsbManager manager = UsbManager.getInstance(this);

부가기능 라이브러리를 사용하지 않는다면 다음과 같은 방식으로 UsbManager 객체를 얻어야 합니다.

Kotlin

val manager = getSystemService(Context.USB_SERVICE) as UsbManager

자바

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

인텐트 필터를 사용하여 연결된 액세서리를 필터링하면 UsbAccessory 객체가 애플리케이션입니다. 부가기능 라이브러리를 사용한다면 다음과 같은 방식으로 UsbAccessory 객체를 얻어야 합니다.

Kotlin

val accessory = UsbManager.getAccessory(intent)

자바

UsbAccessory accessory = UsbManager.getAccessory(intent);

부가기능 라이브러리를 사용하지 않는다면 다음과 같은 방식으로 UsbAccessory 객체를 얻어야 합니다.

Kotlin

val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory

자바

UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

Android manifest 요구사항

다음 목록은 선언하기 전에 애플리케이션의 매니페스트 파일에 추가해야 하는 항목을 설명합니다. USB 액세서리 API를 사용합니다. 매니페스트 및 리소스 파일 예는 이러한 항목을 선언하는 방법을 보여줍니다.

모든 Android 지원 기기가 USB 액세서리 API를 지원한다고 보장할 수 없기 때문에 애플리케이션이 사용한다고 선언하는 <uses-feature> 요소를 포함해야 합니다. android.hardware.usb.accessory 기능
부가기능 라이브러리 <uses-library> 요소를 추가하여 라이브러리의 경우 com.android.future.usb.accessory입니다.
부가기능 라이브러리를 사용하는 경우 애플리케이션의 최소 SDK를 API 수준 10으로 설정합니다. android.hardware.usb 패키지를 사용하는 경우 12입니다.
애플리케이션이 연결된 USB 액세서리에 대한 알림을 받도록 하려면 <intent-filter> 및 <meta-data> 요소 쌍: android.hardware.usb.action.USB_ACCESSORY_ATTACHED 인텐트를 처리하세요. <meta-data> 요소는 다음과 같은 외부 XML 리소스 파일을 가리킵니다. 감지하려는 액세서리에 관한 식별 정보를 선언합니다.

XML 리소스 파일에서 다음의 <usb-accessory> 요소를 선언합니다. 선택합니다. 각 <usb-accessory>는 다음과 같은 속성이 포함됩니다.
- manufacturer
- model
- version
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 시스템은 애플리케이션이 연결된 액세서리에 관심이 있는지 여부를 결정합니다. 이 경우 액세서리와의 통신을 재개하세요. 통신을 설정하려면 애플리케이션에서 다음과 같이 해야 합니다.

액세서리를 필터링하는 인텐트 필터를 사용하여 연결된 액세서리를 탐색하세요. 연결된 액세서리를 열거하고 적절한 액세서리를 찾는 것입니다.
아직 액세스 권한이 없는 경우 사용자에게 액세서리와 통신할 수 있는 권한을 요청합니다. 얻을 수 있습니다.
적절한 인터페이스에서 데이터를 읽고 써서 액세서리와 통신합니다. 엔드포인트가 있습니다

액세서리 찾기

애플리케이션은 인텐트 필터를 사용하여 액세서리를 검색할 수 있으며 사용자가 액세서리를 연결하거나 이미 연결된 액세서리를 열거하는 것입니다. 인텐트 필터는 애플리케이션이 잘못된 인텐트를 자동으로 감지하도록 하려는 경우에 유용합니다. 교체합니다. 연결된 액세서리를 열거하면 모든 액세서리 목록을 가져오려는 경우 유용합니다 애플리케이션이 인텐트를 필터링하지 않은 경우)에 영향을 미치지 않습니다.

인텐트 필터 사용

애플리케이션이 특정 USB 액세서리를 검색하게 하려면 인텐트 필터를 지정하면 됩니다. android.hardware.usb.action.USB_ACCESSORY_ATTACHED 인텐트를 필터링합니다. 따라 이 인텐트 필터를 사용하면 USB의 속성을 지정하는 리소스 파일을 지정해야 합니다. 제조업체, 모델, 버전과 같은 액세서리가 포함됩니다.

다음 예는 인텐트 필터를 선언하는 방법을 보여줍니다.

<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를 가져올 수 있습니다. 연결된 액세서리를 다음과 같이 인텐트에서 삭제합니다 (부가기능 라이브러리 사용).

Kotlin

val accessory = UsbManager.getAccessory(intent)

자바

UsbAccessory accessory = UsbManager.getAccessory(intent);

또는 다음과 같이 얻을 수 있습니다(플랫폼 API 사용 시).

Kotlin

val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory

자바

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

자바

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
UsbAccessory[] accessoryList = manager.getAccessoryList();

참고: 다음에서 연결된 액세서리는 하나만 지원됩니다. 할 수 있습니다.

액세서리와 통신할 수 있는 권한 얻기

USB 액세서리와 통신하려면 애플리케이션에 먼저 있습니다.

참고: 애플리케이션에서 연결된 액세서리를 검색할 수 있도록 인텐트 필터가 자동으로 수신됩니다. 권한을 부여할 수 있습니다. 그렇지 않은 경우 명시적으로 권한을 부여해야 합니다.

다음과 같은 일부 상황에서는 명시적으로 권한을 요청해야 할 수 있습니다. 애플리케이션이 이미 연결된 액세서리를 열거하고 있습니다 액세서리와 통신하려고 하기 전에 액세서리에 액세스할 수 있는 권한이 있는지 확인해야 합니다. 그렇지 않은 경우 사용자가 있습니다.

명시적으로 권한을 얻으려면 먼저 broadcast receiver를 생성하세요. 이 수신기는 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")
                }
            }
        }
    }
}

자바

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)

자바

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)

자바

UsbAccessory accessory;
...
usbManager.requestPermission(accessory, permissionIntent);

사용자가 대화상자에 답장하면 broadcast receiver는 불리언인 추가 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()
    }
}

자바

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바이트이므로 버퍼가 항상 다음과 같다고 선언할 수 있습니다. 편의상 사용합니다.

참고: 하위 수준에서는 USB의 경우 패킷이 64바이트입니다. 최대 속도의 액세서리와 512바이트의 USB 고속 액세서리가 제공됩니다. Android 액세서리 프로토콜은 편의를 위해 두 속도의 패킷을 함께 하나의 논리 패킷으로 묶습니다.

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
            }
        }
    }
}

자바

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를 생성하면 애플리케이션이 실행되는 동안 분리된 이벤트만 처리하도록 할 수 있습니다. 이렇게 하면 분리된 이벤트가 현재 실행 중인 애플리케이션으로만 전송되며 모든 애플리케이션에 브로드캐스트되지는 않습니다.