Home | History | Annotate | Download | only in hdmi 
      1 package android.hardware.hdmi;
      2 
      3 import android.annotation.NonNull;
      4 import android.annotation.SystemApi;
      5 import android.hardware.hdmi.HdmiControlManager.VendorCommandListener;
      6 import android.os.RemoteException;
      7 import android.util.Log;
      8 
      9 /**
     10  * Parent for classes of various HDMI-CEC device type used to access
     11  * the HDMI control system service. Contains methods and data used in common.
     12  *
     13  * @hide
     14  */
     15 @SystemApi
     16 public abstract class HdmiClient {
     17     private static final String TAG = "HdmiClient";
     18 
     19     /* package */ final IHdmiControlService mService;
     20 
     21     private IHdmiVendorCommandListener mIHdmiVendorCommandListener;
     22 
     23     /* package */ abstract int getDeviceType();
     24 
     25     /* package */ HdmiClient(IHdmiControlService service) {
     26         mService = service;
     27     }
     28 
     29     /**
     30      * Returns the active source information.
     31      *
     32      * @return {@link HdmiDeviceInfo} object that describes the active source
     33      *         or active routing path
     34      */
     35     public HdmiDeviceInfo getActiveSource() {
     36         try {
     37             return mService.getActiveSource();
     38         } catch (RemoteException e) {
     39             Log.e(TAG, "getActiveSource threw exception ", e);
     40         }
     41         return null;
     42     }
     43 
     44     /**
     45      * Sends a key event to other logical device.
     46      *
     47      * @param keyCode key code to send. Defined in {@link android.view.KeyEvent}.
     48      * @param isPressed true if this is key press event
     49      */
     50     public void sendKeyEvent(int keyCode, boolean isPressed) {
     51         try {
     52             mService.sendKeyEvent(getDeviceType(), keyCode, isPressed);
     53         } catch (RemoteException e) {
     54             Log.e(TAG, "sendKeyEvent threw exception ", e);
     55         }
     56     }
     57 
     58     /**
     59      * Sends vendor-specific command.
     60      *
     61      * @param targetAddress address of the target device
     62      * @param params vendor-specific parameter. For <Vendor Command With ID> do not
     63      *               include the first 3 bytes (vendor ID).
     64      * @param hasVendorId {@code true} if the command type will be <Vendor Command With ID>.
     65      *                    {@code false} if the command will be <Vendor Command>
     66      */
     67     public void sendVendorCommand(int targetAddress, byte[] params, boolean hasVendorId) {
     68         try {
     69             mService.sendVendorCommand(getDeviceType(), targetAddress, params, hasVendorId);
     70         } catch (RemoteException e) {
     71             Log.e(TAG, "failed to send vendor command: ", e);
     72         }
     73     }
     74 
     75     /**
     76      * Sets a listener used to receive incoming vendor-specific command.
     77      *
     78      * @param listener listener object
     79      */
     80     public void setVendorCommandListener(@NonNull VendorCommandListener listener) {
     81         if (listener == null) {
     82             throw new IllegalArgumentException("listener cannot be null");
     83         }
     84         if (mIHdmiVendorCommandListener != null) {
     85             throw new IllegalStateException("listener was already set");
     86         }
     87         try {
     88             IHdmiVendorCommandListener wrappedListener = getListenerWrapper(listener);
     89             mService.addVendorCommandListener(wrappedListener, getDeviceType());
     90             mIHdmiVendorCommandListener = wrappedListener;
     91         } catch (RemoteException e) {
     92             Log.e(TAG, "failed to set vendor command listener: ", e);
     93         }
     94     }
     95 
     96     private static IHdmiVendorCommandListener getListenerWrapper(
     97             final VendorCommandListener listener) {
     98         return new IHdmiVendorCommandListener.Stub() {
     99             @Override
    100             public void onReceived(int srcAddress, int destAddress, byte[] params,
    101                     boolean hasVendorId) {
    102                 listener.onReceived(srcAddress, destAddress, params, hasVendorId);
    103             }
    104             @Override
    105             public void onControlStateChanged(boolean enabled, int reason) {
    106                 listener.onControlStateChanged(enabled, reason);
    107             }
    108         };
    109     }
    110 }
    111