HdmiControlManager.java revision 66d1eb285b129836d1b3c392ed609283c0dbf830
191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim/* 291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Copyright (C) 2014 The Android Open Source Project 391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Licensed under the Apache License, Version 2.0 (the "License"); 591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * you may not use this file except in compliance with the License. 691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * You may obtain a copy of the License at 791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * http://www.apache.org/licenses/LICENSE-2.0 991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 1091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Unless required by applicable law or agreed to in writing, software 1191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * distributed under the License is distributed on an "AS IS" BASIS, 1291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * See the License for the specific language governing permissions and 1491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * limitations under the License. 1591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 1691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 1791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimpackage android.hardware.hdmi; 1891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 1991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimimport android.annotation.Nullable; 2066d1eb285b129836d1b3c392ed609283c0dbf830Jinsuk Kimimport android.annotation.SystemApi; 2178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kimimport android.os.RemoteException; 2278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 2391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim/** 2491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * The {@link HdmiControlManager} class is used to send HDMI control messages 2591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * to attached CEC devices. 2691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 2791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Provides various HDMI client instances that represent HDMI-CEC logical devices 2891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * hosted in the system. {@link #getTvClient()}, for instance will return an 2991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * {@link HdmiTvClient} object if the system is configured to host one. Android system 3091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * can host more than one logical CEC devices. If multiple types are configured they 3191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * all work as if they were independent logical devices running in the system. 3266d1eb285b129836d1b3c392ed609283c0dbf830Jinsuk Kim * 3366d1eb285b129836d1b3c392ed609283c0dbf830Jinsuk Kim * @hide 3491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 3566d1eb285b129836d1b3c392ed609283c0dbf830Jinsuk Kim@SystemApi 3691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimpublic final class HdmiControlManager { 3791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable private final IHdmiControlService mService; 3891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 3978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // True if we have a logical device of type playback hosted in the system. 4078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private final boolean mHasPlaybackDevice; 4178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // True if we have a logical device of type TV hosted in the system. 4278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private final boolean mHasTvDevice; 4378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 4491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 4591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @hide - hide this constructor because it has a parameter of type 4691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * IHdmiControlService, which is a system private class. The right way 4791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * to create an instance of this class is using the factory 4891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Context.getSystemService. 4991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 5091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiControlManager(IHdmiControlService service) { 5191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim mService = service; 5278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim int[] types = null; 5378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService != null) { 5478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 5578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim types = mService.getSupportedTypes(); 5678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 5778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 5878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 5978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mHasTvDevice = hasDeviceType(types, HdmiCec.DEVICE_TV); 6178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mHasPlaybackDevice = hasDeviceType(types, HdmiCec.DEVICE_PLAYBACK); 6278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 6478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private static boolean hasDeviceType(int[] types, int type) { 6578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (types == null) { 6678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return false; 6778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim for (int t : types) { 6978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (t == type) { 7078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return true; 7178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 7278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 7378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return false; 7491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 7591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 7691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 7791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Gets an object that represents a HDMI-CEC logical device of type playback on the system. 7891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 7991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Used to send HDMI control messages to other devices like TV or audio amplifier through 8091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * HDMI bus. It is also possible to communicate with other logical devices hosted in the same 8191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * system if the system is configured to host more than one type of HDMI-CEC logical devices. 8291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 8391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @return {@link HdmiPlaybackClient} instance. {@code null} on failure. 8491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 8591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable 8691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiPlaybackClient getPlaybackClient() { 8778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null || !mHasPlaybackDevice) { 8891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return null; 8991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 9091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return new HdmiPlaybackClient(mService); 9191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 9291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 9391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 9491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Gets an object that represents a HDMI-CEC logical device of type TV on the system. 9591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 9691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Used to send HDMI control messages to other devices and manage them through 9791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * HDMI bus. It is also possible to communicate with other logical devices hosted in the same 9891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * system if the system is configured to host more than one type of HDMI-CEC logical devices. 9991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 10091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @return {@link HdmiTvClient} instance. {@code null} on failure. 10191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 10291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable 10391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiTvClient getTvClient() { 10478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null || !mHasTvDevice) { 10578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return null; 10691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 10791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return new HdmiTvClient(mService); 10891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 10978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 11078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 11178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Listener used to get hotplug event from HDMI port. 11278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 11378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public interface HotplugEventListener { 11478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim void onReceived(HdmiHotplugEvent event); 11578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 11678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 11778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 11878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Adds a listener to get informed of {@link HdmiHotplugEvent}. 11978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 12078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * <p>To stop getting the notification, 1219302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim * use {@link #removeHotplugEventListener(HotplugEventListener)}. 12278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 12378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * @param listener {@link HotplugEventListener} instance 1249302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim * @see HdmiControlManager#removeHotplugEventListener(HotplugEventListener) 12578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 12678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public void addHotplugEventListener(HotplugEventListener listener) { 12778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null) { 12878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return; 12978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 13078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 13178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mService.addHotplugEventListener(getHotplugEventListenerWrapper(listener)); 13278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 13378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 13478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 13578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 13678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 13778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 13878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Removes a listener to stop getting informed of {@link HdmiHotplugEvent}. 13978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 14078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * @param listener {@link HotplugEventListener} instance to be removed 14178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 1429302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim public void removeHotplugEventListener(HotplugEventListener listener) { 14378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null) { 14478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return; 14578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 14678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 14778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mService.removeHotplugEventListener(getHotplugEventListenerWrapper(listener)); 14878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 14978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 15078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 15178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 15278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 15378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private IHdmiHotplugEventListener getHotplugEventListenerWrapper( 15478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim final HotplugEventListener listener) { 15578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return new IHdmiHotplugEventListener.Stub() { 15678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public void onReceived(HdmiHotplugEvent event) { 15778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim listener.onReceived(event);; 15878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 15978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim }; 16078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 16191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim} 162