SHOW Signed

net.rim.device.api.system
Interface PeripheralListener

public interface PeripheralListener

The listener interface for receiving peripheral events.

Peripherals, such as the travel charger, are used to extend the functionality of the BlackBerry.

Note this API is only supported on 857/957 and 5810/5820 handhelds.

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:

JDE 3.6.0

Field Summary

	static int	TYPE_CAR_CHARGER Indicates that the RIM car charger peripheral is attached to the device.
	static int	TYPE_CRADLE Indicates that device is attached to the cradle.
	static int	TYPE_NONE Indicates that no peripheral is found.
	static int	TYPE_TRAVEL_CHARGER Indicates that the RIM travel charger peripheral is attached to the device.
	static int	TYPE_UNKNOWN Indicates that the attached peripheral is of an unknown type.
	static int	TYPE_USER Indicates that a recognized third party peripheral is attached to the device.

Method Summary

void

peripheralChange(int type) Invoked when the state of the peripheral port changes.

Field Detail

TYPE_UNKNOWN

public static final int TYPE_UNKNOWN

Indicates that the attached peripheral is of an unknown type.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_USER

public static final int TYPE_USER

Indicates that a recognized third party peripheral is attached to the device.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_CAR_CHARGER

public static final int TYPE_CAR_CHARGER

Indicates that the RIM car charger peripheral is attached to the device.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_CRADLE

public static final int TYPE_CRADLE

Indicates that device is attached to the cradle.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_NONE

public static final int TYPE_NONE

Indicates that no peripheral is found.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_TRAVEL_CHARGER

public static final int TYPE_TRAVEL_CHARGER

Indicates that the RIM travel charger peripheral is attached to the device.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Method Detail

peripheralChange

public void peripheralChange(int type)

Invoked when the state of the peripheral port changes.

Parameters:

type - Current type of peripheral attached to the device, or TYPE_NONE if no peripheral is currently attached. Any one of the above values are valid.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.