ACRCloud provides services such as Music Recognition, Broadcast Monitoring, Custom Audio Recognition, Copyright Compliance & Data Deduplication, Live Channel Detection, and Offline Recognition etc.
This audio recognition java SDK support most of audio / video files.
Audio: mp3, wav, m4a, flac, aac, amr, ape, ogg ...
Video: mp4, mkv, wmv, flv, ts, avi ...
Follow one of the tutorials to create a project and get your host, access_key and access_secret.
- Recognize Music
- Recognize Custom Content
- Broadcast Monitoring for Music
- Broadcast Monitoring for Custom Content
- Detect Live & Timeshift TV Channels
- Recognize Custom Content Offline
- Recognize Live Channels and Custom Content
If you run the SDK on Windows, you must install this library.
X86: download and install Library(windows/vcredist_x86.exe)
x64: download and install Library(windows/vcredist_x64.exe)
- You must not modify package name "com.acrcloud.utils".
- If you run the SDK on Windows, you must install library(vcredist).
<dependency>
<groupId>com.acrcloud.sdks</groupId>
<artifactId>com.acrcloud.sdks.recognizer</artifactId>
<version>1.0.5</version>
</dependency>Introduction all API.
public String recognizeByFile(String filePath, int startSeconds)
/**
*
* recognize by file path of (Audio/Video file)
* Audio: mp3, wav, m4a, flac, aac, amr, ape, ogg ...
* Video: mp4, mkv, wmv, flv, ts, avi ...
*
* @param filePath query file path
* @param startSeconds skip (startSeconds) seconds from from the beginning of (filePath)
*
* @return result
*
**/
public String recognizeByFileBuffer(byte[] fileBuffer, int fileBufferLen, int startSeconds)
/**
*
* recognize by buffer of (Audio/Video file)
* Audio: mp3, wav, m4a, flac, aac, amr, ape, ogg ...
* Video: mp4, mkv, wmv, flv, ts, avi ...
*
* @param fileBuffer query buffer
* @param fileBufferLen the length of fileBufferLen
* @param startSeconds skip (startSeconds) seconds from from the beginning of fileBuffer
*
* @return result
*
**/
public String recognize(byte[] wavAudioBuffer, int wavAudioBufferLen)
/**
*
* recognize by wav audio buffer(RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, mono 8000 Hz)
*
* @param wavAudioBuffer query audio buffer
* @param wavAudioBufferLen the length of wavAudioBuffer
*
* @return result
*
**/public static byte[] createFingerprintByFile(String fileName, int startTimeSeconds, int audioLenSeconds, boolean isDB)
//fileName: Path of input file;
//startTimeSeconds: Start time of input file, default is 0;
//audioLenSeconds: Length of audio data you need. if you create recogize frigerprint, default is 12 seconds, if you create db frigerprint, it is not usefully;
//isDB: If it is True, it will create db frigerprint;
//@return "ACRCloud Fingerprint". If can not create frigerprint, return null.
public static byte[] createFingerprintByFileBuffer(byte[] dataBuffer, int dataBufferLen, int startTimeSeconds, int audioLenSeconds, boolean isDB)
//dataBuffer: data buffer of input file;
//dataBufferLen: length of dataBuffer
//startTimeSeconds: Start time of input file, default is 0;
//audioLenSeconds: Length of audio data you need. if you create recogize frigerprint, default is 12 seconds, if you create db frigerprint, it is not usefully;
//isDB: If it is True, it will create db frigerprint;
//@return "ACRCloud Fingerprint". If can not create frigerprint, return null.
public static byte[] createFingerprint(byte[] dataBuffer, int dataBufferLen, boolean isDB)
//dataBuffer: audio data buffer(RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, mono 8000 Hz);
//isDB: If it is True, it will create db frigerprint;
//@return "ACRCloud Fingerprint". If can not create frigerprint, return null.
public static byte[] decodeAudioByFile(String fileName, int startTimeSeconds, int audioLenSeconds)
//It will return the audio data(RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, mono 8000 Hz);
//fileName: Path of input file;
//startTimeSeconds: Start time of input file, default is 0;
//audioLenSeconds: Length of audio data you need, if it is 0, will decode all the audio;
//@return audio data.
public static byte[] decodeAudioByFileBuffer(byte[] dataBuffer, int dataBufferLen, int startTimeSeconds, int audioLenSeconds)
//It will return the audio data(RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, mono 8000 Hz);
//dataBuffer: data buffer of input file;
//startTimeSeconds: Start time of input file, default is 0;
//audioLenSeconds: Length of audio data you need, if it is 0, will decode all the audio;
//@return audio data.
def version()
//return the version of this modulerun Test:
>>> cd test
Replace "xxxxxxxx" below with your project's access_key and access_secret.
>>> sh run.sh
import java.io.*;
import java.util.Map;
import java.util.HashMap;
import com.acrcloud.utils.ACRCloudRecognizer;
public class Test {
public static void main(String[] args) {
Map<String, Object> config = new HashMap<String, Object>();
// replace "XXXXXXXX" with your project's host, access_key and access_secret
config.put("host", "XXXXXXXX");
config.put("access_key", "XXXXXXXX");
config.put("access_secret", "XXXXXXXX");
config.put("debug", false);
config.put("timeout", 10); // seconds
ACRCloudRecognizer re = new ACRCloudRecognizer(config);
// It will skip 80 seconds.
String result = re.recognizeByFile(args[0], 80);
System.out.println(result);
/**
*
* recognize by buffer of (Formatter: Audio/Video)
* Audio: mp3, wav, m4a, flac, aac, amr, ape, ogg ...
* Video: mp4, mkv, wmv, flv, ts, avi ...
*
*
**/
File file = new File(args[0]);
byte[] buffer = new byte[3 * 1024 * 1024];
if (!file.exists()) {
return;
}
FileInputStream fin = null;
int bufferLen = 0;
try {
fin = new FileInputStream(file);
bufferLen = fin.read(buffer, 0, buffer.length);
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
if (fin != null) {
fin.close();
}
} catch (IOException e) {
e.printStackTrace();
}
}
System.out.println("bufferLen=" + bufferLen);
if (bufferLen <= 0)
return;
// It will skip 80 seconds from the begginning of (buffer).
result = re.recognizeByFileBuffer(buffer, bufferLen, 80);
System.out.println(result);
}
}1. create java project:
2. add jar library, click right-hand on "commons-codec-1.10.jar" >> Build Path >> Add to Build Path:
3.add (dll or so) library:
