##Featured in:
##What is this library for? UserAwareVideoView is a customizable VideoView that smartly play and pause the video based on your user is looking at the video or not. This uses Play Services Mobile Vision APIs to detect user's eyes. If the user is not looking at the screen than this will automatically pause the video, so your user does not miss any part of the video.
##How to use this library???
###Gradle dependency:
Add these lines to your build.gradle file to start integration.
dependency{
compile 'com.kevalpatel2106:userawarevideoview:1.0.2'
}
- This library automatically adds
android.permission.CAMERApermission in your applicationsAndroidManifest.xmlfile.
###Add to XML layout:
You can use UserAwareVideoView just like you user the default VideoView in your layout.
<com.kevalpatel.userawarevieoview.UserAwareVideoView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/video_view"/>
###Initialize in your activity:
- Step-1: Check for the Camera permission in runtime.
- Step-2: Register
UserAwarenessListenerto get the callbacks from theUserAwareVideoViewwhenever error occurs in eyes detection or eye detection starts stops. - Step-3: Handle errors that may occur while eyes detection.
mVideoView = (UserAwareVideoView) findViewById(R.id.video_view);
mVideoView.setUserAwarenessListener(new UserAwarenessListener() {
@Override
public void onErrorOccurred(int errorCode) {
//Handle errors.
switch (errorCode) {
case Errors.UNDEFINED:
//Unknown error occured.
//This will stop eye tracking, but video will keep playing.
break;
case Errors.FRONT_CAMERA_NOT_AVAILABLE:
//This indicates that device doesnot have the front camera
//This will stop eye tracking, but video will keep playing.
break;
case Errors.CAMERA_PERMISSION_NOT_AVAILABLE:
//This indicates that camera permission is not available.
//Ask for the runtime camera permission.
break;
case Errors.LOW_LIGHT:
//This indicates that there is dark out side. We cannot detect user's face.
//This will stop eye tracking, but video will keep playing.
break;
}
}
@Override
public void onEyeTrackingStarted() {
//Eye detection started
}
@Override
public void onEyeTrackingStop() {
//Eye detection is stopped.
}
});
//Atatch your media controller, provide video to play and start the video
//......
//......
That's it. UserAwareVideoView is ready to use.
##Demo
- You can download the sample apk from here.
- The video in sample apk is streamed online. So, make sure you have active internet connection.
##Contribute: ####Simple 3 step to contribute into this repo:
- Fork the project.
- Make required changes and commit.
- Generate pull request. Mention all the required description regarding changes you made.