forked from vbartacek/aacdecoder-android
-
Notifications
You must be signed in to change notification settings - Fork 7
/
README
159 lines (106 loc) · 4.52 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
Freeware Advanced Audio (AAC) Decoder for Android
http://www.spoledge.com
The source code can be obtained at http://code.google.com/p/aacdecoder-android/
This is a port of the "OpenCORE aacdec" open source library to Android platform.
COPYRIGHTS
==========
For this software the following license applies:
******************************************************************************
** AACDecoder - Freeware Advanced Audio (AAC) Decoder for Android
** Copyright (C) 2011 - 2014 Spolecne s.r.o., http://www.spoledge.com
**
** This file is a part of AACDecoder.
**
** AACDecoder is free software; you can redistribute it and/or modify
** it under the terms of the GNU Lesser General Public License as published
** by the Free Software Foundation; either version 3 of the License,
** or (at your option) any later version.
**
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU Lesser General Public License for more details.
**
** You should have received a copy of the GNU Lesser General Public License
** along with this program. If not, see <http://www.gnu.org/licenses/>.
******************************************************************************
NOTE-OpenCORE:
This software uses libraries from the OpenCORE project under the Apache
License, Version 2.0. (see decoder/jni/opencore-aacdec/Apache-LICENSE-2.0.txt).
For more information about OpenCORE aacdec, please visit
http://code.google.com/p/opencore-aacdec/
!!! PLEASE NOTE !!!
That using of this software may require the payment of
patent royalties. You need to consider this issue before you start
building derivative works. We are not warranting or indemnifying you in
any way for patent royalities! YOU ARE SOLELY RESPONSIBLE FOR YOUR OWN
ACTIONS!
For more information about the AAC patents, please visit
http://www.vialicensing.com/licensing/aac-fees.aspx
OVERVIEW
========
The project contains two modules:
- decoder
- player
The "decoder" module contains the Java and C code used for wrapping
the underlying AAC decoding algorithm (which is currently the OpenCORE aacdec,
but it could be easily changed).
The "player" module is an example how to use the "decoder" library in your
project.
INSTALLING
==========
Requirements:
- Android SDK - at least platform 3 (Android 1.5)
- Android NDK - tested with r6, r9c
Preparing OpenCORE sources:
-------------------------
You have to download Android OpenCORE sources either by:
* downloading Android OpenCORE sources from our "Downloads" tab:
http://code.google.com/p/aacplayer-android/downloads/list
Please note that each version of thei decoder library needs specific
OpenCORE version. In the downloads list select that one which
is just below the relevant source/libs archives.
If you download a zip file, then please unzip it.
Compiling:
----------
1) copy sample.ant.properties to .ant.properties and edit .ant.properties:
- path to Android SDK
- path to Android NDK
- path to Android OpenCORE source
2) run ant
3) install the APK on the emulator or a device:
adb install player/bin/AACMP3Player-debug.apk
USING THE AAC DECODER LIBRARY FOR OTHER PROJECTS
================================================
Preparing:
----------
You must copy both Java JAR and the shared library files to your
project's "libs" directory:
$ cp -R decoder/libs <your_android_project>/libs
Using:
------
Please look at the example activity using the AAC decoder:
player/src/com/spoledge/aacplay/AACPlayerActivity.java
USING MAVEN
===========
Starting with the version 0.7 the project can be built using Maven.
NOTE: You have to configure the .ant.properties to point to the OpenCORE
sources (see above)
You must install Android 1.5_r4 into your Maven repository.
Please see https://code.google.com/p/maven-android-plugin/ how to use
Maven for Android projects.
When you have you maven for Android ready, then just do:
$ mvn install
Then start an emulator or attach a device, go to the "decoder" dir
and run:
$ mvn android:deploy
Using the apklib by other projects is as easy as the demo "player"
is using it (see the player/pom.xml):
<dependencies>
<dependency>
<groupId>com.spoledge.aacdecoder</groupId>
<artifactId>aacdecoder-lib</artifactId>
<version>0.8</version>
<type>apklib</type>
</dependency>
</dependencies>