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 getDeviceType()23 /* package */ abstract int getDeviceType(); 24 HdmiClient(IHdmiControlService service)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 */ getActiveSource()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 */ sendKeyEvent(int keyCode, boolean isPressed)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 */ sendVendorCommand(int targetAddress, byte[] params, boolean hasVendorId)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 */ setVendorCommandListener(@onNull VendorCommandListener listener)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 getListenerWrapper( final VendorCommandListener listener)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