| /* |
| * 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.telecom; |
| |
| import android.os.RemoteException; |
| |
| import com.android.internal.telecom.IInCallAdapter; |
| |
| /** |
| * Receives commands from {@link InCallService} implementations which should be executed by |
| * Telecom. When Telecom binds to a {@link InCallService}, an instance of this class is given to |
| * the in-call service through which it can manipulate live (active, dialing, ringing) calls. When |
| * the in-call service is notified of new calls, it can use the |
| * given call IDs to execute commands such as {@link #answerCall} for incoming calls or |
| * {@link #disconnectCall} for active calls the user would like to end. Some commands are only |
| * appropriate for calls in certain states; please consult each method for such limitations. |
| * <p> |
| * The adapter will stop functioning when there are no more calls. |
| * |
| * {@hide} |
| */ |
| public final class InCallAdapter { |
| private final IInCallAdapter mAdapter; |
| |
| /** |
| * {@hide} |
| */ |
| public InCallAdapter(IInCallAdapter adapter) { |
| mAdapter = adapter; |
| } |
| |
| /** |
| * Instructs Telecom to answer the specified call. |
| * |
| * @param callId The identifier of the call to answer. |
| * @param videoState The video state in which to answer the call. |
| */ |
| public void answerCall(String callId, int videoState) { |
| try { |
| mAdapter.answerCall(callId, videoState); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to reject the specified call. |
| * |
| * @param callId The identifier of the call to reject. |
| * @param rejectWithMessage Whether to reject with a text message. |
| * @param textMessage An optional text message with which to respond. |
| */ |
| public void rejectCall(String callId, boolean rejectWithMessage, String textMessage) { |
| try { |
| mAdapter.rejectCall(callId, rejectWithMessage, textMessage); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to disconnect the specified call. |
| * |
| * @param callId The identifier of the call to disconnect. |
| */ |
| public void disconnectCall(String callId) { |
| try { |
| mAdapter.disconnectCall(callId); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to put the specified call on hold. |
| * |
| * @param callId The identifier of the call to put on hold. |
| */ |
| public void holdCall(String callId) { |
| try { |
| mAdapter.holdCall(callId); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to release the specified call from hold. |
| * |
| * @param callId The identifier of the call to release from hold. |
| */ |
| public void unholdCall(String callId) { |
| try { |
| mAdapter.unholdCall(callId); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Mute the microphone. |
| * |
| * @param shouldMute True if the microphone should be muted. |
| */ |
| public void mute(boolean shouldMute) { |
| try { |
| mAdapter.mute(shouldMute); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Sets the audio route (speaker, bluetooth, etc...). See {@link AudioState}. |
| * |
| * @param route The audio route to use. |
| */ |
| public void setAudioRoute(int route) { |
| try { |
| mAdapter.setAudioRoute(route); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to play a dual-tone multi-frequency signaling (DTMF) tone in a call. |
| * |
| * Any other currently playing DTMF tone in the specified call is immediately stopped. |
| * |
| * @param callId The unique ID of the call in which the tone will be played. |
| * @param digit A character representing the DTMF digit for which to play the tone. This |
| * value must be one of {@code '0'} through {@code '9'}, {@code '*'} or {@code '#'}. |
| */ |
| public void playDtmfTone(String callId, char digit) { |
| try { |
| mAdapter.playDtmfTone(callId, digit); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to stop any dual-tone multi-frequency signaling (DTMF) tone currently |
| * playing. |
| * |
| * DTMF tones are played by calling {@link #playDtmfTone(String,char)}. If no DTMF tone is |
| * currently playing, this method will do nothing. |
| * |
| * @param callId The unique ID of the call in which any currently playing tone will be stopped. |
| */ |
| public void stopDtmfTone(String callId) { |
| try { |
| mAdapter.stopDtmfTone(callId); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to continue playing a post-dial DTMF string. |
| * |
| * A post-dial DTMF string is a string of digits entered after a phone number, when dialed, |
| * that are immediately sent as DTMF tones to the recipient as soon as the connection is made. |
| * While these tones are playing, Telecom will notify the {@link InCallService} that the call |
| * is in the post dial state. |
| * |
| * If the DTMF string contains a {@link TelecomManager#DTMF_CHARACTER_PAUSE} symbol, Telecom |
| * will temporarily pause playing the tones for a pre-defined period of time. |
| * |
| * If the DTMF string contains a {@link TelecomManager#DTMF_CHARACTER_WAIT} symbol, Telecom |
| * will pause playing the tones and notify the {@link InCallService} that the call is in the |
| * post dial wait state. When the user decides to continue the postdial sequence, the |
| * {@link InCallService} should invoke the {@link #postDialContinue(String,boolean)} method. |
| * |
| * @param callId The unique ID of the call for which postdial string playing should continue. |
| * @param proceed Whether or not to continue with the post-dial sequence. |
| */ |
| public void postDialContinue(String callId, boolean proceed) { |
| try { |
| mAdapter.postDialContinue(callId, proceed); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to add a PhoneAccountHandle to the specified call |
| * |
| * @param callId The identifier of the call |
| * @param accountHandle The PhoneAccountHandle through which to place the call |
| */ |
| public void phoneAccountSelected(String callId, PhoneAccountHandle accountHandle) { |
| try { |
| mAdapter.phoneAccountSelected(callId, accountHandle); |
| } catch (RemoteException e) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to conference the specified call. |
| * |
| * @param callId The unique ID of the call. |
| * @hide |
| */ |
| public void conference(String callId, String otherCallId) { |
| try { |
| mAdapter.conference(callId, otherCallId); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to split the specified call from any conference call with which it may be |
| * connected. |
| * |
| * @param callId The unique ID of the call. |
| * @hide |
| */ |
| public void splitFromConference(String callId) { |
| try { |
| mAdapter.splitFromConference(callId); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to merge child calls of the specified conference call. |
| */ |
| public void mergeConference(String callId) { |
| try { |
| mAdapter.mergeConference(callId); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to swap the child calls of the specified conference call. |
| */ |
| public void swapConference(String callId) { |
| try { |
| mAdapter.swapConference(callId); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to turn the proximity sensor on. |
| */ |
| public void turnProximitySensorOn() { |
| try { |
| mAdapter.turnOnProximitySensor(); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecom to turn the proximity sensor off. |
| * |
| * @param screenOnImmediately If true, the screen will be turned on immediately if it was |
| * previously off. Otherwise, the screen will only be turned on after the proximity sensor |
| * is no longer triggered. |
| */ |
| public void turnProximitySensorOff(boolean screenOnImmediately) { |
| try { |
| mAdapter.turnOffProximitySensor(screenOnImmediately); |
| } catch (RemoteException ignored) { |
| } |
| } |
| |
| /** |
| * Instructs Telecomm to switch to other active subscripion |
| * |
| * @param sub switch to this subscription |
| * @param retainLch whether LCH on switched sub should be retained. |
| * {@hide} |
| */ |
| public void switchToOtherActiveSub(String sub, boolean retainLch) { |
| try { |
| mAdapter.switchToOtherActiveSub(sub, retainLch); |
| } catch (RemoteException e) { |
| } |
| } |
| } |