Package com.castlabs.sdk.thumbs

Interface DefaultThumbnailView.Callback

Enclosing class:

DefaultThumbnailView

public static interface DefaultThumbnailView.Callback

Users of this render must provide an implementation of this callback when they call DefaultThumbnailView.show(long, Callback). The callbacks getThumbnailRect(Rect, ThumbnailInfo, boolean) method is then used to determine the desired size and location of the thumbnail.

Method Summary

Modifier and Type	Method	Description
void	getThumbnailRect(Rect output, DefaultThumbnailView.ThumbnailInfo info, boolean isSmallScreen)	Called on the main thread as part of the DefaultThumbnailView.onDraw(Canvas) implementation.

Method Details

getThumbnailRect

void getThumbnailRect(Rect output,
 DefaultThumbnailView.ThumbnailInfo info,
 boolean isSmallScreen)

Called on the main thread as part of the DefaultThumbnailView.onDraw(Canvas) implementation. Do not perform any heavy duty tasks in the implementation of this method.

The purpose of this call is that the implementer fills the values of the provided output rectangle. The thumbnail will that be rendered inside that rectangle. Note tha the image will be rendered starting in the top left corner and the renderer will try to respect the desired size, but it will always maintain the original aspect ratio. An example implementation of this interface can look like:

 public void getThumbnailRect(Rect output, DefaultThumbnailView.ThumbnailInfo info, boolean isSmallScreen) {
        if(!isSmallScreen) {
                // If we are not in a small screen, we take the
                // video container and render on top of it. This assumes that
                // the thumbnail has the same aspect ratio as the video, so that
                // the whole view will be covered
                ViewGroup videoView = playerView.getVideoView();
                output.set(
                                videoView.getLeft(),
                                videoView.getTop(),
                                videoView.getRight(),
                                videoView.getBottom());
        } else {
                // If this is not a small screen device, we scale up the original thumbnail
                // 2x and draw it on top of our bottom container that holds the seekbar
                // and leave some space to the left and right
                int tw = thumbWidth * 2;
                int th = thumbHeight * 2;
                int left = (int) (10 + (bottomContainer.getWidth() - tw - 20) * lastSeekBarProgressPercent);
                int top = bottomContainer.getTop() - th - 30;
                output.set(left, top, left + tw, top + th);
        }
 }
 

The example above assumes that the DefaultThumbnailView view sits on top of the PlayerView and has the same dimensions. We then fill the output rectangle using the coordinates of the PlayerView.getVideoView(), which is the container that holds the video surface and has the same dimensions as the currently played video frame. This means that the thumbnail will be scaled up and will overlay the video view entirely. In contrast to the full screen behaviour on the small screen, we use a smaller but still scaled version of the thumbnail in case we are on a bigger screen. In that case the thumbnail is positioned above our bottom container that holds the seek bar and we let it follow the seek-bar movement.

Parameters:

output - The output rectangle that needs to be filled in the implementation of this method

info - Thumbnail information. For performance reasons, the instance of this object will be modified and re-used in subsequent calls of this method.

isSmallScreen - True if the current screen was detected as a small screen.