PlaybackControlsRowPresenter.java revision 60bb6af2e336072921f5d3c3861e86b3cc6241b3
1/* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except 5 * in compliance with the License. You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software distributed under the License 10 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express 11 * or implied. See the License for the specific language governing permissions and limitations under 12 * the License. 13 */ 14package android.support.v17.leanback.widget; 15 16import android.support.v17.leanback.R; 17import android.support.v17.leanback.widget.ControlBarPresenter.OnControlClickedListener; 18import android.support.v17.leanback.widget.ControlBarPresenter.OnControlSelectedListener; 19import android.content.Context; 20import android.graphics.Color; 21import android.util.TypedValue; 22import android.view.KeyEvent; 23import android.view.LayoutInflater; 24import android.view.View; 25import android.view.ViewGroup; 26import android.view.ViewGroup.LayoutParams; 27import android.view.ViewGroup.MarginLayoutParams; 28import android.widget.ImageView; 29 30/** 31 * A PlaybackControlsRowPresenter renders a {@link PlaybackControlsRow} to display a 32 * series of playback control buttons. Typically this row will be the first row in a fragment 33 * such as the {@link android.support.v17.leanback.app.PlaybackOverlayFragment 34 * PlaybackControlsFragment}. 35 */ 36public class PlaybackControlsRowPresenter extends RowPresenter { 37 38 static class BoundData extends PlaybackControlsPresenter.BoundData { 39 ViewHolder mRowViewHolder; 40 } 41 42 /** 43 * A ViewHolder for the PlaybackControlsRow. 44 */ 45 public class ViewHolder extends RowPresenter.ViewHolder { 46 public final Presenter.ViewHolder mDescriptionViewHolder; 47 final ViewGroup mCard; 48 final ImageView mImageView; 49 final ViewGroup mDescriptionDock; 50 final ViewGroup mControlsDock; 51 final ViewGroup mSecondaryControlsDock; 52 final View mSpacer; 53 final View mBottomSpacer; 54 View mBgView; 55 int mCardHeight; 56 int mControlsDockMarginStart; 57 int mControlsDockMarginEnd; 58 PlaybackControlsPresenter.ViewHolder mControlsVh; 59 Presenter.ViewHolder mSecondaryControlsVh; 60 BoundData mControlsBoundData = new BoundData(); 61 BoundData mSecondaryBoundData = new BoundData(); 62 Presenter.ViewHolder mSelectedViewHolder; 63 Object mSelectedItem; 64 final PlaybackControlsRow.OnPlaybackStateChangedListener mListener = 65 new PlaybackControlsRow.OnPlaybackStateChangedListener() { 66 @Override 67 public void onCurrentTimeChanged(int ms) { 68 mPlaybackControlsPresenter.setCurrentTime(mControlsVh, ms); 69 } 70 @Override 71 public void onBufferedProgressChanged(int ms) { 72 mPlaybackControlsPresenter.setSecondaryProgress(mControlsVh, ms); 73 } 74 }; 75 76 ViewHolder(View rootView, Presenter descriptionPresenter) { 77 super(rootView); 78 mCard = (ViewGroup) rootView.findViewById(R.id.controls_card); 79 mImageView = (ImageView) rootView.findViewById(R.id.image); 80 mDescriptionDock = (ViewGroup) rootView.findViewById(R.id.description_dock); 81 mControlsDock = (ViewGroup) rootView.findViewById(R.id.controls_dock); 82 mSecondaryControlsDock = 83 (ViewGroup) rootView.findViewById(R.id.secondary_controls_dock); 84 mSpacer = rootView.findViewById(R.id.spacer); 85 mBottomSpacer = rootView.findViewById(R.id.bottom_spacer); 86 mDescriptionViewHolder = descriptionPresenter == null ? null : 87 descriptionPresenter.onCreateViewHolder(mDescriptionDock); 88 if (mDescriptionViewHolder != null) { 89 mDescriptionDock.addView(mDescriptionViewHolder.view); 90 } 91 } 92 93 void dispatchItemSelection() { 94 if (!isSelected()) { 95 return; 96 } 97 if (mSelectedViewHolder == null) { 98 if (getOnItemSelectedListener() != null) { 99 getOnItemSelectedListener().onItemSelected(null, getRow()); 100 } 101 if (getOnItemViewSelectedListener() != null) { 102 getOnItemViewSelectedListener().onItemSelected(null, null, 103 ViewHolder.this, getRow()); 104 } 105 } else { 106 if (getOnItemSelectedListener() != null) { 107 getOnItemSelectedListener().onItemSelected(mSelectedItem, getRow()); 108 } 109 if (getOnItemViewSelectedListener() != null) { 110 getOnItemViewSelectedListener().onItemSelected(mSelectedViewHolder, mSelectedItem, 111 ViewHolder.this, getRow()); 112 } 113 } 114 }; 115 116 Presenter getPresenter(boolean primary) { 117 ObjectAdapter adapter = primary ? 118 ((PlaybackControlsRow) getRow()).getPrimaryActionsAdapter() : 119 ((PlaybackControlsRow) getRow()).getSecondaryActionsAdapter(); 120 if (adapter == null) { 121 return null; 122 } 123 if (adapter.getPresenterSelector() instanceof ControlButtonPresenterSelector) { 124 ControlButtonPresenterSelector selector = 125 (ControlButtonPresenterSelector) adapter.getPresenterSelector(); 126 return primary ? selector.getPrimaryPresenter() : 127 selector.getSecondaryPresenter(); 128 } 129 return adapter.getPresenter(adapter.size() > 0 ? adapter.get(0) : null); 130 } 131 132 void setBackground(View view) { 133 if (mBgView != null) { 134 RoundedRectHelper.getInstance().clearBackground(mBgView); 135 ShadowHelper.getInstance().setZ(mBgView, 0); 136 } 137 mBgView = view; 138 RoundedRectHelper.getInstance().setRoundedRectBackground(view, mBackgroundColorSet ? 139 mBackgroundColor : getDefaultBackgroundColor(view.getContext())); 140 141 if (sShadowZ == 0) { 142 sShadowZ = view.getResources().getDimensionPixelSize( 143 R.dimen.lb_playback_controls_z); 144 } 145 ShadowHelper.getInstance().setZ(view, sShadowZ); 146 } 147 } 148 149 private int mBackgroundColor = Color.TRANSPARENT; 150 private boolean mBackgroundColorSet; 151 private int mProgressColor = Color.TRANSPARENT; 152 private boolean mProgressColorSet; 153 private boolean mSecondaryActionsHidden; 154 private Presenter mDescriptionPresenter; 155 private PlaybackControlsPresenter mPlaybackControlsPresenter; 156 private ControlBarPresenter mSecondaryControlsPresenter; 157 private OnActionClickedListener mOnActionClickedListener; 158 private static float sShadowZ; 159 160 private final OnControlSelectedListener mOnControlSelectedListener = 161 new OnControlSelectedListener() { 162 @Override 163 public void onControlSelected(Presenter.ViewHolder itemViewHolder, Object item, 164 ControlBarPresenter.BoundData data) { 165 ViewHolder vh = ((BoundData) data).mRowViewHolder; 166 if (vh.mSelectedViewHolder != itemViewHolder || vh.mSelectedItem != item) { 167 vh.mSelectedViewHolder = itemViewHolder; 168 vh.mSelectedItem = item; 169 vh.dispatchItemSelection(); 170 } 171 } 172 }; 173 174 private final OnControlClickedListener mOnControlClickedListener = 175 new OnControlClickedListener() { 176 @Override 177 public void onControlClicked(Presenter.ViewHolder itemViewHolder, Object item, 178 ControlBarPresenter.BoundData data) { 179 ViewHolder vh = ((BoundData) data).mRowViewHolder; 180 if (getOnItemClickedListener() != null) { 181 getOnItemClickedListener().onItemClicked(item, vh.getRow()); 182 } 183 if (getOnItemViewClickedListener() != null) { 184 getOnItemViewClickedListener().onItemClicked(itemViewHolder, item, 185 vh, vh.getRow()); 186 } 187 if (mOnActionClickedListener != null && item instanceof Action) { 188 mOnActionClickedListener.onActionClicked((Action) item); 189 } 190 } 191 }; 192 193 /** 194 * Constructor for a PlaybackControlsRowPresenter. 195 * 196 * @param descriptionPresenter Presenter for displaying item details. 197 */ 198 public PlaybackControlsRowPresenter(Presenter descriptionPresenter) { 199 setHeaderPresenter(null); 200 setSelectEffectEnabled(false); 201 202 mDescriptionPresenter = descriptionPresenter; 203 mPlaybackControlsPresenter = new PlaybackControlsPresenter(R.layout.lb_playback_controls); 204 mSecondaryControlsPresenter = new ControlBarPresenter(R.layout.lb_control_bar); 205 206 mPlaybackControlsPresenter.setOnControlSelectedListener(mOnControlSelectedListener); 207 mSecondaryControlsPresenter.setOnControlSelectedListener(mOnControlSelectedListener); 208 mPlaybackControlsPresenter.setOnControlClickedListener(mOnControlClickedListener); 209 mSecondaryControlsPresenter.setOnControlClickedListener(mOnControlClickedListener); 210 } 211 212 /** 213 * Constructor for a PlaybackControlsRowPresenter. 214 */ 215 public PlaybackControlsRowPresenter() { 216 this(null); 217 } 218 219 /** 220 * Sets the listener for {@link Action} click events. 221 */ 222 public void setOnActionClickedListener(OnActionClickedListener listener) { 223 mOnActionClickedListener = listener; 224 } 225 226 /** 227 * Gets the listener for {@link Action} click events. 228 */ 229 public OnActionClickedListener getOnActionClickedListener() { 230 return mOnActionClickedListener; 231 } 232 233 /** 234 * Sets the background color. If not set, a default from the theme will be used. 235 */ 236 public void setBackgroundColor(int color) { 237 mBackgroundColor = color; 238 mBackgroundColorSet = true; 239 } 240 241 /** 242 * Returns the background color. If no background color was set, transparent 243 * is returned. 244 */ 245 public int getBackgroundColor() { 246 return mBackgroundColor; 247 } 248 249 /** 250 * Sets the primary color for the progress bar. If not set, a default from 251 * the theme will be used. 252 */ 253 public void setProgressColor(int color) { 254 mProgressColor = color; 255 mProgressColorSet = true; 256 } 257 258 /** 259 * Returns the primary color for the progress bar. If no color was set, transparent 260 * is returned. 261 */ 262 public int getProgressColor() { 263 return mProgressColor; 264 } 265 266 /** 267 * Sets the secondary actions to be hidden behind a "more actions" button. 268 * When "more actions" is selected, the primary actions are replaced with 269 * the secondary actions. 270 */ 271 public void setSecondaryActionsHidden(boolean hidden) { 272 mSecondaryActionsHidden = hidden; 273 } 274 275 /** 276 * Returns true if secondary actions are hidden. 277 */ 278 public boolean areSecondaryActionsHidden() { 279 return mSecondaryActionsHidden; 280 } 281 282 /** 283 * Shows or hides space at the bottom of the playback controls row. 284 * This allows the row to hug the bottom of the display when no 285 * other rows are present. 286 */ 287 public void showBottomSpace(ViewHolder vh, boolean show) { 288 vh.mBottomSpacer.setVisibility(show ? View.VISIBLE : View.GONE); 289 } 290 291 /** 292 * Display the primary actions. 293 */ 294 public void showPrimaryActions(ViewHolder vh) { 295 mPlaybackControlsPresenter.showPrimaryActions(vh.mControlsVh); 296 } 297 298 private int getDefaultBackgroundColor(Context context) { 299 TypedValue outValue = new TypedValue(); 300 context.getTheme().resolveAttribute(R.attr.defaultBrandColor, outValue, true); 301 return context.getResources().getColor(outValue.resourceId); 302 } 303 304 private int getDefaultProgressColor(Context context) { 305 TypedValue outValue = new TypedValue(); 306 context.getTheme().resolveAttribute(R.attr.playbackProgressPrimaryColor, outValue, true); 307 return context.getResources().getColor(outValue.resourceId); 308 } 309 310 @Override 311 protected RowPresenter.ViewHolder createRowViewHolder(ViewGroup parent) { 312 View v = LayoutInflater.from(parent.getContext()) 313 .inflate(R.layout.lb_playback_controls_row, parent, false); 314 ViewHolder vh = new ViewHolder(v, mDescriptionPresenter); 315 initRow(vh); 316 return vh; 317 } 318 319 private void initRow(final ViewHolder vh) { 320 vh.mCardHeight = vh.mCard.getLayoutParams().height; 321 322 MarginLayoutParams lp = (MarginLayoutParams) vh.mControlsDock.getLayoutParams(); 323 vh.mControlsDockMarginStart = lp.getMarginStart(); 324 vh.mControlsDockMarginEnd = lp.getMarginEnd(); 325 326 vh.mControlsVh = (PlaybackControlsPresenter.ViewHolder) 327 mPlaybackControlsPresenter.onCreateViewHolder(vh.mControlsDock); 328 mPlaybackControlsPresenter.setProgressColor(vh.mControlsVh, 329 mProgressColorSet ? mProgressColor : 330 getDefaultProgressColor(vh.mControlsDock.getContext())); 331 vh.mControlsDock.addView(vh.mControlsVh.view); 332 333 vh.mSecondaryControlsVh = 334 mSecondaryControlsPresenter.onCreateViewHolder(vh.mSecondaryControlsDock); 335 if (!mSecondaryActionsHidden) { 336 vh.mSecondaryControlsDock.addView(vh.mSecondaryControlsVh.view); 337 } 338 ((PlaybackControlsRowView) vh.view).setOnUnhandledKeyListener( 339 new PlaybackControlsRowView.OnUnhandledKeyListener() { 340 @Override 341 public boolean onUnhandledKey(KeyEvent event) { 342 if (vh.getOnKeyListener() != null) { 343 if (vh.getOnKeyListener().onKey(vh.view, event.getKeyCode(), event)) { 344 return true; 345 } 346 } 347 return false; 348 } 349 }); 350 } 351 352 @Override 353 protected void onBindRowViewHolder(RowPresenter.ViewHolder holder, Object item) { 354 super.onBindRowViewHolder(holder, item); 355 356 ViewHolder vh = (ViewHolder) holder; 357 PlaybackControlsRow row = (PlaybackControlsRow) vh.getRow(); 358 359 mPlaybackControlsPresenter.enableSecondaryActions(mSecondaryActionsHidden); 360 361 if (row.getItem() == null) { 362 LayoutParams lp = vh.mCard.getLayoutParams(); 363 lp.height = LayoutParams.WRAP_CONTENT; 364 vh.mCard.setLayoutParams(lp); 365 vh.mDescriptionDock.setVisibility(View.GONE); 366 vh.mSpacer.setVisibility(View.GONE); 367 } else { 368 LayoutParams lp = vh.mCard.getLayoutParams(); 369 lp.height = vh.mCardHeight; 370 vh.mCard.setLayoutParams(lp); 371 vh.mDescriptionDock.setVisibility(View.VISIBLE); 372 if (vh.mDescriptionViewHolder != null) { 373 mDescriptionPresenter.onBindViewHolder(vh.mDescriptionViewHolder, row.getItem()); 374 } 375 vh.mSpacer.setVisibility(View.VISIBLE); 376 } 377 378 MarginLayoutParams lp = (MarginLayoutParams) vh.mControlsDock.getLayoutParams(); 379 if (row.getImageDrawable() == null || row.getItem() == null) { 380 vh.mImageView.setImageDrawable(null); 381 vh.setBackground(vh.mControlsDock); 382 lp.setMarginStart(0); 383 lp.setMarginEnd(0); 384 mPlaybackControlsPresenter.enableTimeMargins(vh.mControlsVh, true); 385 } else { 386 vh.mImageView.setImageDrawable(row.getImageDrawable()); 387 vh.setBackground(vh.mCard); 388 lp.setMarginStart(vh.mControlsDockMarginStart); 389 lp.setMarginEnd(vh.mControlsDockMarginEnd); 390 mPlaybackControlsPresenter.enableTimeMargins(vh.mControlsVh, false); 391 } 392 vh.mControlsDock.setLayoutParams(lp); 393 394 vh.mControlsBoundData.adapter = row.getPrimaryActionsAdapter(); 395 vh.mControlsBoundData.secondaryActionsAdapter = row.getSecondaryActionsAdapter(); 396 vh.mControlsBoundData.presenter = vh.getPresenter(true); 397 vh.mControlsBoundData.mRowViewHolder = vh; 398 mPlaybackControlsPresenter.onBindViewHolder(vh.mControlsVh, vh.mControlsBoundData); 399 400 vh.mSecondaryBoundData.adapter = row.getSecondaryActionsAdapter(); 401 vh.mSecondaryBoundData.presenter = vh.getPresenter(false); 402 vh.mSecondaryBoundData.mRowViewHolder = vh; 403 mSecondaryControlsPresenter.onBindViewHolder(vh.mSecondaryControlsVh, 404 vh.mSecondaryBoundData); 405 406 mPlaybackControlsPresenter.setTotalTime(vh.mControlsVh, row.getTotalTime()); 407 mPlaybackControlsPresenter.setCurrentTime(vh.mControlsVh, row.getCurrentTime()); 408 mPlaybackControlsPresenter.setSecondaryProgress(vh.mControlsVh, row.getBufferedProgress()); 409 row.setOnPlaybackStateChangedListener(vh.mListener); 410 } 411 412 @Override 413 protected void onUnbindRowViewHolder(RowPresenter.ViewHolder holder) { 414 ViewHolder vh = (ViewHolder) holder; 415 PlaybackControlsRow row = (PlaybackControlsRow) vh.getRow(); 416 417 if (vh.mDescriptionViewHolder != null) { 418 mDescriptionPresenter.onUnbindViewHolder(vh.mDescriptionViewHolder); 419 } 420 mPlaybackControlsPresenter.onUnbindViewHolder(vh.mControlsVh); 421 mSecondaryControlsPresenter.onUnbindViewHolder(vh.mSecondaryControlsVh); 422 row.setOnPlaybackStateChangedListener(null); 423 424 super.onUnbindRowViewHolder(holder); 425 } 426 427 protected void onRowViewSelected(RowPresenter.ViewHolder vh, boolean selected) { 428 super.onRowViewSelected(vh, selected); 429 if (selected) { 430 ((ViewHolder) vh).dispatchItemSelection(); 431 } 432 } 433 434 @Override 435 protected void onRowViewAttachedToWindow(RowPresenter.ViewHolder vh) { 436 super.onRowViewAttachedToWindow(vh); 437 if (mDescriptionPresenter != null) { 438 mDescriptionPresenter.onViewAttachedToWindow( 439 ((ViewHolder) vh).mDescriptionViewHolder); 440 } 441 } 442 443 @Override 444 protected void onRowViewDetachedFromWindow(RowPresenter.ViewHolder vh) { 445 super.onRowViewDetachedFromWindow(vh); 446 if (mDescriptionPresenter != null) { 447 mDescriptionPresenter.onViewDetachedFromWindow( 448 ((ViewHolder) vh).mDescriptionViewHolder); 449 } 450 } 451} 452