Skip to content

Most visited

Recently visited

navigation
Added in API level 12

UsbAccessory

public class UsbAccessory
extends Object implements Parcelable

java.lang.Object
   ↳ android.hardware.usb.UsbAccessory


A class representing a USB accessory, which is an external hardware component that communicates with an android application over USB. The accessory is the USB host and android the device side of the USB connection.

When the accessory connects, it reports its manufacturer and model names, the version of the accessory, and a user visible description of the accessory to the device. The manufacturer, model and version strings are used by the USB Manager to choose an appropriate application for the accessory. The accessory may optionally provide a unique serial number and a URL to for the accessory's website to the device as well.

An instance of this class is sent to the application via the ACTION_USB_ACCESSORY_ATTACHED Intent. The application can then call openAccessory(UsbAccessory) to open a file descriptor for reading and writing data to and from the accessory.

Developer Guides

For more information about communicating with USB hardware, read the USB developer guide.

Summary

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<UsbAccessory> CREATOR

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

boolean equals(Object obj)

Compares this instance with the specified object and indicates if they are equal.

String getDescription()

Returns a user visible description of the accessory.

String getManufacturer()

Returns the manufacturer name of the accessory.

String getModel()

Returns the model name of the accessory.

String getSerial()

Returns the unique serial number for the accessory.

String getUri()

Returns the URI for the accessory.

String getVersion()

Returns the version of the accessory.

int hashCode()

Returns an integer hash code for this object.

String toString()

Returns a string containing a concise, human-readable description of this object.

void writeToParcel(Parcel parcel, int flags)

Flatten this object in to a Parcel.

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Fields

CREATOR

Added in API level 12
Creator<UsbAccessory> CREATOR

Public methods

describeContents

Added in API level 12
int describeContents ()

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Returns
int a bitmask indicating the set of special object types marshalled by the Parcelable.

equals

Added in API level 12
boolean equals (Object obj)

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o. See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Parameters
obj Object: the object to compare this instance with.
Returns
boolean true if the specified object is equal to this Object; false otherwise.

getDescription

Added in API level 12
String getDescription ()

Returns a user visible description of the accessory.

Returns
String the accessory description

getManufacturer

Added in API level 12
String getManufacturer ()

Returns the manufacturer name of the accessory.

Returns
String the accessory manufacturer

getModel

Added in API level 12
String getModel ()

Returns the model name of the accessory.

Returns
String the accessory model

getSerial

Added in API level 12
String getSerial ()

Returns the unique serial number for the accessory. This is an optional serial number that can be used to differentiate between individual accessories of the same model and manufacturer

Returns
String the unique serial number

getUri

Added in API level 12
String getUri ()

Returns the URI for the accessory. This is an optional URI that might show information about the accessory or provide the option to download an application for the accessory

Returns
String the accessory URI

getVersion

Added in API level 12
String getVersion ()

Returns the version of the accessory.

Returns
String the accessory version

hashCode

Added in API level 12
int hashCode ()

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Returns
int this object's hash code.

toString

Added in API level 12
String toString ()

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Returns
String a printable representation of this object.

writeToParcel

Added in API level 12
void writeToParcel (Parcel parcel, 
                int flags)

Flatten this object in to a Parcel.

Parameters
parcel Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.