1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.hardware.hdmi;
import android.annotation.SystemApi;
import android.os.RemoteException;
import android.util.Log;
/**
* HdmiPlaybackClient represents HDMI-CEC logical device of type Playback
* in the Android system which acts as a playback device such as set-top box.
* It provides with methods that control, get information from TV/Display device
* connected through HDMI bus.
*
* @hide
*/
@SystemApi
public final class HdmiPlaybackClient extends HdmiClient {
private static final String TAG = "HdmiPlaybackClient";
// Logical address of TV. The secondary TV is not handled.
private static final int ADDR_TV = 0;
/**
* Listener used by the client to get the result of one touch play operation.
*/
public interface OneTouchPlayCallback {
/**
* Called when the result of the feature one touch play is returned.
*
* @param result the result of the operation. {@link HdmiControlManager#RESULT_SUCCESS}
* if successful.
*/
public void onComplete(int result);
}
/**
* Listener used by the client to get display device status.
*/
public interface DisplayStatusCallback {
/**
* Called when display device status is reported.
*
* @param status display device status. It should be one of the following values.
* <ul>
* <li>{@link HdmiControlManager#POWER_STATUS_ON}
* <li>{@link HdmiControlManager#POWER_STATUS_STANDBY}
* <li>{@link HdmiControlManager#POWER_STATUS_TRANSIENT_TO_ON}
* <li>{@link HdmiControlManager#POWER_STATUS_TRANSIENT_TO_STANDBY}
* <li>{@link HdmiControlManager#POWER_STATUS_UNKNOWN}
* </ul>
*/
public void onComplete(int status);
}
/* package */ HdmiPlaybackClient(IHdmiControlService service) {
super(service);
}
/**
* Performs the feature 'one touch play' from playback device to turn on display
* and switch the input.
*
* @param callback {@link OneTouchPlayCallback} object to get informed
* of the result
*/
public void oneTouchPlay(OneTouchPlayCallback callback) {
// TODO: Use PendingResult.
try {
mService.oneTouchPlay(getCallbackWrapper(callback));
} catch (RemoteException e) {
Log.e(TAG, "oneTouchPlay threw exception ", e);
}
}
@Override
public int getDeviceType() {
return HdmiDeviceInfo.DEVICE_PLAYBACK;
}
/**
* Gets the status of display device connected through HDMI bus.
*
* @param callback {@link DisplayStatusCallback} object to get informed
* of the result
*/
public void queryDisplayStatus(DisplayStatusCallback callback) {
try {
mService.queryDisplayStatus(getCallbackWrapper(callback));
} catch (RemoteException e) {
Log.e(TAG, "queryDisplayStatus threw exception ", e);
}
}
/**
* Sends a <Standby> command to TV.
*/
public void sendStandby() {
try {
mService.sendStandby(getDeviceType(), HdmiDeviceInfo.idForCecDevice(ADDR_TV));
} catch (RemoteException e) {
Log.e(TAG, "sendStandby threw exception ", e);
}
}
private IHdmiControlCallback getCallbackWrapper(final OneTouchPlayCallback callback) {
return new IHdmiControlCallback.Stub() {
@Override
public void onComplete(int result) {
callback.onComplete(result);
}
};
}
private IHdmiControlCallback getCallbackWrapper(final DisplayStatusCallback callback) {
return new IHdmiControlCallback.Stub() {
@Override
public void onComplete(int status) {
callback.onComplete(status);
}
};
}
}
|
