/*
 * 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.net.Uri;
import android.os.Handler;
import android.os.IBinder;
import android.os.Looper;
import android.os.Message;
import android.os.RemoteException;
import android.telecom.InCallService.VideoCall;
import android.view.Surface;

import com.android.internal.annotations.VisibleForTesting;
import com.android.internal.os.SomeArgs;
import com.android.internal.telecom.IVideoCallback;
import com.android.internal.telecom.IVideoProvider;

Implementation of a Video Call, which allows InCallUi to communicate commands to the underlying VideoProvider, and direct callbacks from the VideoProvider to the appropriate Listener. {@hide}
/** * Implementation of a Video Call, which allows InCallUi to communicate commands to the underlying * {@link Connection.VideoProvider}, and direct callbacks from the * {@link Connection.VideoProvider} to the appropriate {@link VideoCall.Listener}. * * {@hide} */
public class VideoCallImpl extends VideoCall { private final IVideoProvider mVideoProvider; private final VideoCallListenerBinder mBinder; private VideoCall.Callback mCallback; private int mVideoQuality = VideoProfile.QUALITY_UNKNOWN; private int mVideoState = VideoProfile.STATE_AUDIO_ONLY; private final String mCallingPackageName; private int mTargetSdkVersion; private IBinder.DeathRecipient mDeathRecipient = new IBinder.DeathRecipient() { @Override public void binderDied() { mVideoProvider.asBinder().unlinkToDeath(this, 0); } };
IVideoCallback stub implementation.
/** * IVideoCallback stub implementation. */
private final class VideoCallListenerBinder extends IVideoCallback.Stub { @Override public void receiveSessionModifyRequest(VideoProfile videoProfile) { if (mHandler == null) { return; } mHandler.obtainMessage(MessageHandler.MSG_RECEIVE_SESSION_MODIFY_REQUEST, videoProfile).sendToTarget(); } @Override public void receiveSessionModifyResponse(int status, VideoProfile requestProfile, VideoProfile responseProfile) { if (mHandler == null) { return; } SomeArgs args = SomeArgs.obtain(); args.arg1 = status; args.arg2 = requestProfile; args.arg3 = responseProfile; mHandler.obtainMessage(MessageHandler.MSG_RECEIVE_SESSION_MODIFY_RESPONSE, args) .sendToTarget(); } @Override public void handleCallSessionEvent(int event) { if (mHandler == null) { return; } mHandler.obtainMessage(MessageHandler.MSG_HANDLE_CALL_SESSION_EVENT, event) .sendToTarget(); } @Override public void changePeerDimensions(int width, int height) { if (mHandler == null) { return; } SomeArgs args = SomeArgs.obtain(); args.arg1 = width; args.arg2 = height; mHandler.obtainMessage(MessageHandler.MSG_CHANGE_PEER_DIMENSIONS, args).sendToTarget(); } @Override public void changeVideoQuality(int videoQuality) { if (mHandler == null) { return; } mHandler.obtainMessage(MessageHandler.MSG_CHANGE_VIDEO_QUALITY, videoQuality, 0) .sendToTarget(); } @Override public void changeCallDataUsage(long dataUsage) { if (mHandler == null) { return; } mHandler.obtainMessage(MessageHandler.MSG_CHANGE_CALL_DATA_USAGE, dataUsage) .sendToTarget(); } @Override public void changeCameraCapabilities(VideoProfile.CameraCapabilities cameraCapabilities) { if (mHandler == null) { return; } mHandler.obtainMessage(MessageHandler.MSG_CHANGE_CAMERA_CAPABILITIES, cameraCapabilities).sendToTarget(); } }
Default handler used to consolidate binder method calls onto a single thread.
/** Default handler used to consolidate binder method calls onto a single thread. */
private final class MessageHandler extends Handler { private static final int MSG_RECEIVE_SESSION_MODIFY_REQUEST = 1; private static final int MSG_RECEIVE_SESSION_MODIFY_RESPONSE = 2; private static final int MSG_HANDLE_CALL_SESSION_EVENT = 3; private static final int MSG_CHANGE_PEER_DIMENSIONS = 4; private static final int MSG_CHANGE_CALL_DATA_USAGE = 5; private static final int MSG_CHANGE_CAMERA_CAPABILITIES = 6; private static final int MSG_CHANGE_VIDEO_QUALITY = 7; public MessageHandler(Looper looper) { super(looper); } @Override public void handleMessage(Message msg) { if (mCallback == null) { return; } SomeArgs args; switch (msg.what) { case MSG_RECEIVE_SESSION_MODIFY_REQUEST: mCallback.onSessionModifyRequestReceived((VideoProfile) msg.obj); break; case MSG_RECEIVE_SESSION_MODIFY_RESPONSE: args = (SomeArgs) msg.obj; try { int status = (int) args.arg1; VideoProfile requestProfile = (VideoProfile) args.arg2; VideoProfile responseProfile = (VideoProfile) args.arg3; mCallback.onSessionModifyResponseReceived( status, requestProfile, responseProfile); } finally { args.recycle(); } break; case MSG_HANDLE_CALL_SESSION_EVENT: mCallback.onCallSessionEvent((int) msg.obj); break; case MSG_CHANGE_PEER_DIMENSIONS: args = (SomeArgs) msg.obj; try { int width = (int) args.arg1; int height = (int) args.arg2; mCallback.onPeerDimensionsChanged(width, height); } finally { args.recycle(); } break; case MSG_CHANGE_CALL_DATA_USAGE: mCallback.onCallDataUsageChanged((long) msg.obj); break; case MSG_CHANGE_CAMERA_CAPABILITIES: mCallback.onCameraCapabilitiesChanged( (VideoProfile.CameraCapabilities) msg.obj); break; case MSG_CHANGE_VIDEO_QUALITY: mVideoQuality = msg.arg1; mCallback.onVideoQualityChanged(msg.arg1); break; default: break; } } }; private Handler mHandler; VideoCallImpl(IVideoProvider videoProvider, String callingPackageName, int targetSdkVersion) throws RemoteException { mVideoProvider = videoProvider; mVideoProvider.asBinder().linkToDeath(mDeathRecipient, 0); mBinder = new VideoCallListenerBinder(); mVideoProvider.addVideoCallback(mBinder); mCallingPackageName = callingPackageName; setTargetSdkVersion(targetSdkVersion); } @VisibleForTesting public void setTargetSdkVersion(int sdkVersion) { mTargetSdkVersion = sdkVersion; } public void destroy() { unregisterCallback(mCallback); }
{@inheritDoc}
/** {@inheritDoc} */
public void registerCallback(VideoCall.Callback callback) { registerCallback(callback, null); }
{@inheritDoc}
/** {@inheritDoc} */
public void registerCallback(VideoCall.Callback callback, Handler handler) { mCallback = callback; if (handler == null) { mHandler = new MessageHandler(Looper.getMainLooper()); } else { mHandler = new MessageHandler(handler.getLooper()); } }
{@inheritDoc}
/** {@inheritDoc} */
public void unregisterCallback(VideoCall.Callback callback) { if (callback != mCallback) { return; } mCallback = null; try { mVideoProvider.removeVideoCallback(mBinder); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setCamera(String cameraId) { try { Log.w(this, "setCamera: cameraId=%s, calling=%s", cameraId, mCallingPackageName); mVideoProvider.setCamera(cameraId, mCallingPackageName, mTargetSdkVersion); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setPreviewSurface(Surface surface) { try { mVideoProvider.setPreviewSurface(surface); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setDisplaySurface(Surface surface) { try { mVideoProvider.setDisplaySurface(surface); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setDeviceOrientation(int rotation) { try { mVideoProvider.setDeviceOrientation(rotation); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setZoom(float value) { try { mVideoProvider.setZoom(value); } catch (RemoteException e) { } }
Sends a session modification request to the video provider.

The InCallService will create the requestProfile based on the current video state (i.e. Details.getVideoState()). It is, however, possible that the video state maintained by the InCallService could get out of sync with what is known by the VideoProvider. To remove ambiguity, the VideoCallImpl passes along the pre-modify video profile to the VideoProvider to ensure it has full context of the requested change.

Params:
  • requestProfile – The requested video profile.
/** * Sends a session modification request to the video provider. * <p> * The {@link InCallService} will create the {@code requestProfile} based on the current * video state (i.e. {@link Call.Details#getVideoState()}). It is, however, possible that the * video state maintained by the {@link InCallService} could get out of sync with what is known * by the {@link android.telecom.Connection.VideoProvider}. To remove ambiguity, the * {@link VideoCallImpl} passes along the pre-modify video profile to the {@code VideoProvider} * to ensure it has full context of the requested change. * * @param requestProfile The requested video profile. */
public void sendSessionModifyRequest(VideoProfile requestProfile) { try { VideoProfile originalProfile = new VideoProfile(mVideoState, mVideoQuality); mVideoProvider.sendSessionModifyRequest(originalProfile, requestProfile); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void sendSessionModifyResponse(VideoProfile responseProfile) { try { mVideoProvider.sendSessionModifyResponse(responseProfile); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void requestCameraCapabilities() { try { mVideoProvider.requestCameraCapabilities(); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void requestCallDataUsage() { try { mVideoProvider.requestCallDataUsage(); } catch (RemoteException e) { } }
{@inheritDoc}
/** {@inheritDoc} */
public void setPauseImage(Uri uri) { try { mVideoProvider.setPauseImage(uri); } catch (RemoteException e) { } }
Sets the video state for the current video call.
Params:
  • videoState – the new video state.
/** * Sets the video state for the current video call. * @param videoState the new video state. */
public void setVideoState(int videoState) { mVideoState = videoState; } }