Skip to content

binzhao88/android-transcoder

 
 

Repository files navigation

android-transcoder

Hardware accelerated transcoder for Android, written in pure Java.

Requirements

API Level 18 (Android 4.3, JELLY_BEAN_MR2) or later. If your app targets older Android, you should add below line to AndroidManifest.xml:

<!-- Only supports API >= 18 -->
<uses-sdk tools:overrideLibrary="net.ypresto.androidtranscoder" />

Please ensure checking Build.VERSION by your self.

Usage

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    ParcelFileDescriptor parcelFileDescriptor = resolver.openFileDescriptor(data.getData(), "r");
    FileDescriptor fileDescriptor = parcelFileDescriptor.getFileDescriptor();
    MediaTranscoder.Listener listener = new MediaTranscoder.Listener() {
        @Override
        public void onTranscodeProgress(double progress) {
            ...
        }

        @Override
        public void onTranscodeCompleted() {
            startActivity(new Intent(Intent.ACTION_VIEW).setDataAndType(Uri.fromFile(file), "video/mp4"));
            ...
        }

        @Override
        public void onTranscodeFailed(Exception exception) {
            ...
        }
    };
    MediaTranscoder.getInstance().transcodeVideo(fileDescriptor, file.getAbsolutePath(),
            MediaFormatStrategyPresets.createAndroid720pStrategy(), listener); // or createAndroid720pStrategy([your bit rate here])
}

See TranscoderActivity.java in example directory for ready-made transcoder app.

Quick Setup

Gradle

Available from JCenter, which is default repo of gradle script generated by recent android studio.

repositories {
   jcenter()
}
compile 'net.ypresto.androidtranscoder:android-transcoder:0.1.9'

Note (PLEASE READ FIRST)

  • This library raises RuntimeExceptions (like IlleagalStateException) in various situations. Please catch it and provide alternate logics. I know this is bad design according to Effective Java; just is TODO.
  • Currently this library does not generate streaming-aware mp4 file. Use qtfaststart-java to place moov atom at beginning of file.
  • Android does not gurantees that all devices have bug-free codecs/accelerators for your codec parameters (especially, resolution). Refer supported media formats for parameters guaranteed by CTS.
  • This library does not support video files recorded by other device like digital cameras, iOS (mov files, including non-baseline profile h.264), etc.

License

Copyright (C) 2015 Yuya Tanaka

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.

References for Android Low-Level Media APIs

About

MP4 video transcode on Android device. Pure Java (not LGPL!). Supports API >= 18.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.8%
  • Shell 0.2%