johnernest02 / recordhelper

Android Recording library offers convenient tools for audio/video recording and playback.

RecordHelper

This is a simple record library from steelkiwi/AndroidRecording, it seems that she don't contribute to the repo anymore.

This project is build on android studio ide and explore all dependence for modules, enjoy it.

Content below is the source readme, i have modify the package. if u have some issues, welcome to pull to me.

Download

allprojects {
    repositories {
       maven {
            url "https://jitpack.io"
        }
    }
}

dependencies {
    compile 'com.github.steelkiwi:AndroidRecording:master'
}

Android Recording Library

Android Recording library offers convenient tools for audio/video recording and playback.

For audio it uses:

• AudioRecord to capture and save audio signal from microphone
• MediaPlayer with MediaController to play recorded audio
• custom Visualizer (like bar chart) to represent audio signal on screen while recording and during playback

For video it uses:

• Camera and MediaRecorder to record a video of specified resolution
• MediaPlayer with MediaController to play recorded video
• custom SurfaceView with adjustable size to properly display Camera preview and recorded video (in portrait and landscape modes)

Record audio: how to use

1. Setup VisualizerView

   <com.hwangjr.recordhelper.visualizer.VisualizerView
   	android:id="@+id/visualizerView"
   	android:layout_width="fill_parent"
   	android:layout_height="100dp" >
   </com.hwangjr.recordhelper.visualizer.VisualizerView>

   visualizerView = (VisualizerView) findViewById(R.id.visualizerView);
   setupVisualizer();
   
   ...
   
   private void setupVisualizer() {
   	Paint paint = new Paint();
   	paint.setStrokeWidth(5f);                     //set bar width
   	paint.setAntiAlias(true);
   	paint.setColor(Color.argb(200, 227, 69, 53)); //set bar color
   	BarGraphRenderer barGraphRendererBottom = new BarGraphRenderer(2, paint, false);
   	visualizerView.addRenderer(barGraphRendererBottom);
   }

2. Start recording thread

    ```java
    private void startRecording() {
    	recordingThread = new AudioRecordingThread(fileName, new AudioRecordingHandler() { //pass file name where to store the recorded audio
    		@Override
    		public void onFftDataCapture(final byte[] bytes) {
    			runOnUiThread(new Runnable() {
    				public void run() {
    					if (visualizerView != null) {
    						visualizerView.updateVisualizerFFT(bytes); //update VisualizerView with new audio portion
    					}
    				}
    			});
    		}
    
    		@Override
    		public void onRecordSuccess() {}
    
    		@Override
    		public void onRecordingError() {}
    
    		@Override
    		public void onRecordSaveError() {}
    	});
    	recordingThread.start();
    }
    ```

3. When done, stop recording

    ```java
    private void stopRecording() {
    	if (recordingThread != null) {
    		recordingThread.stopRecording();
    		recordingThread = null;
    	}
    }
    ``` 

Play audio: how to use
------------------------

1. Setup VisualizerView

2. Setup AudioPlaybackManager. It will attach MediaPlayer to a VisualizerView

    ```java
    playbackManager = new AudioPlaybackManager(this, visualizerView, playbackHandler);
    playbackManager.setupPlayback(fileName); //pass file name of the recorded audio
    ``` 

3. Use onscreen MediaController to play/pause/stop/rewind audio


Record video: how to use
------------------------

1. Setup custom SurfaceView (AdaptiveSurfaceView)

    ```xml
    <com.hwangjr.recordhelper.video.AdaptiveSurfaceView
    	android:id="@+id/videoView"
    	android:layout_width="wrap_content"
    	android:layout_height="wrap_content" />
    ``` 

2. Setup RecordingManager

    ```java
    videoView = (AdaptiveSurfaceView) findViewById(R.id.videoView);
    recordingManager = new VideoRecordingManager(videoView, recordingHandler); //pass reference to custom SurfaceView
    ``` 

3. Choose desired video resolution and pass it to RecordingManager, it will adjust size of AdaptiveSurfaceView to properly display Camera output

    ```java
    recordingManager.setPreviewSize(videoSize);
    ``` 

4. To start recording use

    ```java
    recordingManager.startRecording(fileName, videoSize)
    ``` 

5. To stop recording use

    ```java
    recordingManager.stopRecording()
    ``` 

Play video: how to use
------------------------

1. Setup custom SurfaceView (AdaptiveSurfaceView)

2. Setup VideoPlaybackManager. It will attach MediaPlayer to a VisualizerView

    ```java
    playbackManager = new VideoPlaybackManager(this, videoView, playbackHandler);
    playbackManager.setupPlayback(fileName); //pass file name of the recorded video
    ``` 

3. Use onscreen MediaController to play/pause/stop/rewind video


====================================

For more details, please, see the demo project.

License
--------

    Copyright 2015 HwangJR, Inc.

    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.