public final class

LegacySurfacePackage

extends java.lang.Object

 java.lang.Object

↳androidx.car.app.activity.renderer.surface.LegacySurfacePackage

Gradle dependencies

compile group: 'androidx.car.app', name: 'app-automotive', version: '1.7.0-beta01'

  • groupId: androidx.car.app
  • artifactId: app-automotive
  • version: 1.7.0-beta01

Artifact androidx.car.app:app-automotive:1.7.0-beta01 it located at Google repository (https://maven.google.com/)

Overview

A serializable class containing all the data required to render and interact with a surface from an off-process renderer. This class exists for compatibility with Q devices. In Android R and later, will be used instead.

Summary

Constructors
publicLegacySurfacePackage(SurfaceControlCallback callback)

Creates a LegacySurfacePackage.

Methods
from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public LegacySurfacePackage(SurfaceControlCallback callback)

Creates a LegacySurfacePackage.

Parameters:

callback: a SurfaceControlCallback to be registered to receive off-process renderer events affecting the that content is rendered on.

Source

/*
 * Copyright 2021 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 androidx.car.app.activity.renderer.surface;

import static java.util.Objects.requireNonNull;

import android.annotation.SuppressLint;
import android.view.KeyEvent;
import android.view.MotionEvent;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.car.app.annotations.KeepFields;
import androidx.car.app.serialization.Bundleable;
import androidx.car.app.serialization.BundlerException;

/**
 * A serializable class containing all the data required to render and interact with a surface from
 * an off-process renderer.
 *
 * This class exists for compatibility with Q devices. In Android R and later,
 * {@link android.view.SurfaceControlViewHost.SurfacePackage} will be used instead.
 */
@KeepFields
public final class LegacySurfacePackage {
    @Nullable
    private ISurfaceControl mISurfaceControl;

    /**
     * Creates a {@link LegacySurfacePackage}.
     *
     * @param callback a {@link SurfaceControlCallback} to be registered to receive off-process
     *                 renderer events affecting the {@link android.view.SurfaceView} that
     *                 content is rendered on.
     */
    @SuppressLint("ExecutorRegistration")
    public LegacySurfacePackage(@NonNull SurfaceControlCallback callback) {
        requireNonNull(callback);

        mISurfaceControl = new ISurfaceControl.Stub() {
            final SurfaceControlCallback mCallback = callback;

            @Override
            public void setSurfaceWrapper(@NonNull Bundleable surfaceWrapper) {
                requireNonNull(surfaceWrapper);
                try {
                    mCallback.setSurfaceWrapper((SurfaceWrapper) surfaceWrapper.get());
                } catch (BundlerException e) {
                    mCallback.onError("Unable to deserialize surface wrapper", e);
                }
            }

            @Override
            public void onWindowFocusChanged(boolean hasFocus, boolean isInTouchMode) {
                mCallback.onWindowFocusChanged(hasFocus, isInTouchMode);
            }

            @Override
            public void onTouchEvent(@NonNull MotionEvent event) {
                requireNonNull(event);
                mCallback.onTouchEvent(event);
            }

            @Override
            public void onKeyEvent(@NonNull KeyEvent event) {
                requireNonNull(event);
                mCallback.onKeyEvent(event);
            }
        };
    }

    /** Empty constructor needed for serializations. */
    private LegacySurfacePackage() {
    }

    @NonNull
    ISurfaceControl getSurfaceControl() {
        return requireNonNull(mISurfaceControl);
    }
}