Upstream Chrome for Android Cast.

chrome/android/java/src/org/chromium/chrome/browser/media/remote/TransportControl.java

Index: chrome/android/java/src/org/chromium/chrome/browser/media/remote/TransportControl.java
diff --git a/chrome/android/java/src/org/chromium/chrome/browser/media/remote/TransportControl.java b/chrome/android/java/src/org/chromium/chrome/browser/media/remote/TransportControl.java
new file mode 100644
index 0000000000000000000000000000000000000000..71abed7e2cc789964d6a887fb03ce6d0ba5b7ed9
--- /dev/null
+++ b/chrome/android/java/src/org/chromium/chrome/browser/media/remote/TransportControl.java
@@ -0,0 +1,181 @@
+// Copyright 2013 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package org.chromium.chrome.browser.media.remote;
+
+import android.graphics.Bitmap;
+import android.text.TextUtils;
+
+import org.chromium.chrome.browser.media.remote.RemoteVideoInfo.PlayerState;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+
+/**
+ * TransportControl is an abstract base class for various UI views that are intended to control
+ * video playback. TransportControl contains a number of setters that will update the
+ * TransportControl's UI.
+ * Call {@code TransportControl#addListener} with an implementation of
+ * {@code TransportControl.Listener} to receive messages when the user interacts with the
+ * TransportControl.
+ */
+public abstract class TransportControl {
+
+    /**
+     * Base interface for classes that need to listen to transport control events.
+     */
+    public static interface Listener {
+        void onPlay();
+        void onPause();
+        void onSeek(int position);
+        void onStop();
+    }
+
+    private final Set<Listener> mListeners = new CopyOnWriteArraySet<Listener>();
+    private String mScreenName;
+    private String mError;
+    protected RemoteVideoInfo mVideoInfo;
+    private Bitmap mPosterBitmap;
+
+    /**
+     * @return the screen name previously assigned with {@link #setScreenName(String)}.
+     */
+    public final String getScreenName() {
+        return mScreenName;
+    }
+
+    /**
+     * Sets the name to display for the device on the TransportControl.
+     */
+    public final void setScreenName(String screenName) {
+        if (TextUtils.equals(this.mScreenName, screenName)) {
+            return;
+        }
+
+        this.mScreenName = screenName;
+        onScreenNameChanged();
+    }
+
+    /**
+     * @return the error message previously assigned with {@link #setError(String)}, or
+     * {@code null} if {@link #hasError()} returns {@code false}.
+     */
+    public final String getError() {
+        return mError;
+    }
+
+    /**
+     * Sets the error message to display on the TransportControl.
+     * Calling this method with {@code null} or an empty string is equivalent to calling
+     * {@link #clearError()}
+     */
+    public final void setError(/*@Nullable*/ String message) {

[Bernhard Bauer, 2015/03/13 12:18:02]

Why is @Nullable commented out here?

[aberent, 2015/03/13 19:04:35]

No idea, it has been there, and commented out, since the first version in the
Clank repository. Removed since we don't consistently use @Nullable elsewhere.

+        if (TextUtils.equals(mError, message)) {
+            return;
+        }
+
+        mError = TextUtils.isEmpty(message) ? null : message;
+        onErrorChanged();
+    }
+
+    /**
+     * @return true if an error message is assigned to this TransportControl, otherwise false.
+     */
+    public final boolean hasError() {
+        return mError != null;
+    }
+
+    /**
+     * Clears the error message previously assigned by {@code #setError(String)}.
+     */
+    public final void clearError() {
+        setError(null);
+    }
+
+    /**
+     * @return the remote's video information previously assigned with
+     * {@link #setVideoInfo(RemoteVideoInfo)}, or {@code null} if the {@link RemoteVideoInfo}
+     * has not yet been assigned.
+     */
+    public final RemoteVideoInfo getVideoInfo() {
+        return mVideoInfo;
+    }
+
+    /**
+     * Sets the remote's video information to display on the TransportControl.
+     */
+    public final void setVideoInfo(RemoteVideoInfo videoInfo) {
+        if (equal(this.mVideoInfo, videoInfo)) {
+            return;
+        }
+
+        this.mVideoInfo = videoInfo;
+        onVideoInfoChanged();
+    }
+
+    /**
+     * @return the poster bitmap previously assigned with {@link #setPosterBitmap(Bitmap)}, or
+     * {@code null} if the poster bitmap has not yet been assigned.
+     */
+    public final Bitmap getPosterBitmap() {
+        return mPosterBitmap;
+    }
+
+    /**
+     * Sets the poster bitmap to display on the TransportControl.
+     */
+    public final void setPosterBitmap(Bitmap posterBitmap) {
+        if (equal(this.mPosterBitmap, posterBitmap)) {
+            return;
+        }
+
+        this.mPosterBitmap = posterBitmap;
+        onPosterBitmapChanged();
+    }
+
+    /**
+     * Registers a {@link Listener} with the TransportControl.
+     */
+    public void addListener(Listener listener) {
+        mListeners.add(listener);
+    }
+
+    /**
+     * Unregisters a {@link Listener} previously registered with {@link #addListener(Listener)}.
+     */
+    public void removeListener(Listener listener) {
+        mListeners.remove(listener);
+    }
+
+    /**
+     * Displays the TransportControl to the user.
+     */
+    public abstract void show(PlayerState initialState);
+
+    /**
+     * Hides the TransportControl.
+     */
+    public abstract void hide();
+
+    /**
+     * Updates the corresponding route controller.
+     */
+    public abstract void setRouteController(MediaRouteController controller);
+
+    /**
+     * @return the current list of listeners.
+     */
+    protected final Set<Listener> getListeners() {
+        return mListeners;
+    }
+
+    protected void onScreenNameChanged() {}
+    protected void onErrorChanged() {}
+    protected void onVideoInfoChanged() {}
+    protected void onPosterBitmapChanged() {}
+
+    private static boolean equal(Object a, Object b) {
+        return (a == null) ? (b == null) : a.equals(b);
+    }
+}