Skip to content

Most visited

Recently visited

navigation
MediaRouter / src / com.example.android.mediarouter / player /

Player.java

1
/*
2
 * Copyright (C) 2013 The Android Open Source Project
3
 *
4
 * Licensed under the Apache License, Version 2.0 (the "License");
5
 * you may not use this file except in compliance with the License.
6
 * You may obtain a copy of the License at
7
 *
8
 *      http://www.apache.org/licenses/LICENSE-2.0
9
 *
10
 * Unless required by applicable law or agreed to in writing, software
11
 * distributed under the License is distributed on an "AS IS" BASIS,
12
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
 * See the License for the specific language governing permissions and
14
 * limitations under the License.
15
 */
16
 
17
package com.example.android.mediarouter.player;
18
 
19
import android.content.Context;
20
import android.support.v7.media.MediaControlIntent;
21
import android.support.v7.media.MediaRouter.RouteInfo;
22
 
23
/**
24
 * Abstraction of common playback operations of media items, such as play,
25
 * seek, etc. Used by PlaybackManager as a backend to handle actual playback
26
 * of media items.
27
 */
28
public abstract class Player {
29
    protected Callback mCallback;
30
 
31
    public abstract boolean isRemotePlayback();
32
    public abstract boolean isQueuingSupported();
33
 
34
    public abstract void connect(RouteInfo route);
35
    public abstract void release();
36
 
37
    // basic operations that are always supported
38
    public abstract void play(final PlaylistItem item);
39
    public abstract void seek(final PlaylistItem item);
40
    public abstract void getStatus(final PlaylistItem item, final boolean update);
41
    public abstract void pause();
42
    public abstract void resume();
43
    public abstract void stop();
44
 
45
    // advanced queuing (enqueue & remove) are only supported
46
    // if isQueuingSupported() returns true
47
    public abstract void enqueue(final PlaylistItem item);
48
    public abstract PlaylistItem remove(String iid);
49
 
50
    // route statistics
51
    public void updateStatistics() {}
52
    public String getStatistics() { return ""; }
53
 
54
    // presentation display
55
    public void updatePresentation() {}
56
 
57
    public void setCallback(Callback callback) {
58
        mCallback = callback;
59
    }
60
 
61
    public static Player create(Context context, RouteInfo route) {
62
        Player player;
63
        if (route != null && route.supportsControlCategory(
64
                MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) {
65
            player = new RemotePlayer(context);
66
        } else if (route != null) {
67
            player = new LocalPlayer.SurfaceViewPlayer(context);
68
        } else {
69
            player = new LocalPlayer.OverlayPlayer(context);
70
        }
71
        player.connect(route);
72
        return player;
73
    }
74
 
75
    public interface Callback {
76
        void onError();
77
        void onCompletion();
78
        void onPlaylistChanged();
79
        void onPlaylistReady();
80
    }
81
}
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.