1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
/*
* Copyright (C) 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 android.app;
import android.annotation.NonNull;
import android.annotation.TestApi;
import android.os.Parcel;
import android.os.Parcelable;
import java.util.Objects;
/**
* Used by {@link Activity#onPictureInPictureUiStateChanged(PictureInPictureUiState)}.
*/
public final class PictureInPictureUiState implements Parcelable {
private boolean mIsStashed;
/** {@hide} */
PictureInPictureUiState(Parcel in) {
mIsStashed = in.readBoolean();
}
/** {@hide} */
@TestApi
public PictureInPictureUiState(boolean isStashed) {
mIsStashed = isStashed;
}
/**
* Returns whether Picture-in-Picture is stashed or not. A stashed PiP means it is only
* partially visible to the user, with some parts of it being off-screen. This is usually
* an UI state that is triggered by the user, such as flinging the PiP to the edge or letting go
* of PiP while dragging partially off-screen.
*
* Developers can use this in conjunction with
* {@link Activity#onPictureInPictureUiStateChanged(PictureInPictureUiState)} to get a signal
* when the PiP stash state has changed. For example, if the state changed from {@code false} to
* {@code true}, developers can choose to temporarily pause video playback if PiP is of video
* content. Vice versa, if changing from {@code true} to {@code false} and video content is
* paused, developers can resumevideo playback.
*
* @see <a href="http://developer.android.com/about/versions/12/features/pip-improvements">
* Picture in Picture (PiP) improvements</a>
*/
public boolean isStashed() {
return mIsStashed;
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof PictureInPictureUiState)) return false;
PictureInPictureUiState that = (PictureInPictureUiState) o;
return Objects.equals(mIsStashed, that.mIsStashed);
}
@Override
public int hashCode() {
return Objects.hash(mIsStashed);
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(@NonNull Parcel out, int flags) {
out.writeBoolean(mIsStashed);
}
public static final @android.annotation.NonNull Creator<PictureInPictureUiState> CREATOR =
new Creator<PictureInPictureUiState>() {
public PictureInPictureUiState createFromParcel(Parcel in) {
return new PictureInPictureUiState(in);
}
public PictureInPictureUiState[] newArray(int size) {
return new PictureInPictureUiState[size];
}
};
}
|
