Sample Code
The following is some sample code that provides an example of performing a basic "identify music" audio search.
main.py
#!/usr/bin/env python3
import json
import pex
CLIENT_ID = "#YOUR_CLIENT_ID_HERE"
CLIENT_SECRET = "#YOUR_CLIENT_SECRET_HERE"
INPUT_FILE = "/path/to/file.mp3"
def main():
# Initialize and authenticate the client
client = pex.PexSearchClient(CLIENT_ID, CLIENT_SECRET)
# Create an audio fingerprint from input file
ft = client.fingerprint_file(INPUT_FILE, pex.FingerprintType.AUDIO)
# Build an identify music search request
req = pex.PexSearchRequest(fingerprint=ft, type=pex.PexSearchType.IDENTIFY_MUSIC)
# Perform the lookup
result = do_lookup(client, req)
# Print the result
print(json.dumps(result, indent=2))
def do_lookup(client, req):
# These errors are outside of the client's
# control and often resolve after retrying
retryable_errs = (
pex.Code.DEADLINE_EXCEEDED,
pex.Code.INTERNAL_ERROR,
pex.Code.LOOKUP_FAILED,
pex.Code.LOOKUP_TIMED_OUT,
)
while True:
try:
# Start the search
future = client.start_search(req)
# Return the result
return future.get()
except pex.Error as err:
# Raise the error if it's not retryable
if err.code not in retryable_codes:
raise err
# Log the error
print(err)
print("retrying lookup...")
# Sleep for 1s or use exponential backoff
time.sleep(1)
# Retry the lookup
continue
if __name__ == '__main__':
main()main.go
package main
import (
"encoding/json"
"fmt"
pex "github.com/Pexeso/pex-sdk-go/v4"
)
const (
clientID = "#YOUR_CLIENT_ID_HERE"
clientSecret = "#YOUR_CLIENT_SECRET_HERE"
inputFile = "/path/to/file.mp3"
)
func main() {
// Initialize and authenticate the client
client, err := pex.NewPexSearchClient(clientID, clientSecret)
if err != nil {
panic(err)
}
defer client.Close()
// Create an audio fingerprint from input file
ft, err := client.FingerprintFile(inputFile, pex.FingerprintTypeAudio)
if err != nil {
panic(err)
}
// Build an identify music search request
req := &pex.PexSearchRequest{
Fingerprint: ft,
Type: pex.IdentifyMusic,
}
// Perform the lookup
res, err := doLookup(client, req)
if err != nil {
panic(err)
}
// Print the result
j, err := json.MarshalIndent(res, "", " ")
if err != nil {
panic(err)
}
fmt.Println(string(j))
}
func doLookup(client *pex.PexSearchClient, req *pex.PexSearchRequest) (*pex.PexSearchResult, error) {
for {
// Start the search
fut, err := client.StartSearch(req)
if err != nil {
if !isRetryable(err) {
return nil, err
}
// Log the error
fmt.Println(err)
fmt.Println("retrying lookup...")
// Sleep for 1s or use exponential backoff
time.Sleep(time.Second)
// Retry the lookup
continue
}
// Retrieve the result
res, err := fut.Get()
if err != nil {
if !isRetryable(err) {
return nil, err
}
// Log the error
fmt.Println(err)
fmt.Println("retrying lookup...")
// Sleep for 1s or use exponential backoff
time.Sleep(time.Second)
// Retry the lookup
continue
}
return res, nil
}
}
func isRetryable(err error) bool {
pexErr, ok := err.(*pex.Error)
if !ok {
return false
}
// These errors are outside of the client's
// control and often resolve after retrying
switch pexErr.Code {
case pex.StatusDeadlineExceeded:
case pex.StatusInternalError:
case pex.StatusLookupFailed:
case pex.StatusLookupTimedOut:
return true
}
return false
}index.php
<?php
require __DIR__ . '/vendor/autoload.php';
const CLIENT_ID = "#YOUR_CLIENT_ID_HERE";
const CLIENT_SECRET = "#YOUR_CLIENT_SECRET_HERE";
const INPUT_FILE = "/path/to/file.mp3";
function main() {
// Initialize and authenticate the client
$client = new Pex\PexSearchClient(CLIENT_ID, CLIENT_SECRET);
// Create an audio fingerprint from input file
$ft = $client->fingerprintFile(INPUT_FILE, [Pex\FingerprintType::Audio]);
// Build an identify music search request
$req = new Pex\PexSearchRequest($ft, $type=Pex\PexSearchType::IdentifyMusic);
// Perform the lookup
$res = doLookup($client, $req);
// Print the result
var_dump($res);
}
function doLookup($client, $req) {
// These errors are outside of the client's
// control and often resolve after retrying
$retryableCodes = array(
Pex\StatusCode::DeadlineExceeded,
Pex\StatusCode::InternalError,
Pex\StatusCode::LookupFailed,
Pex\StatusCode::LookupTimedOut,
);
while (true) {
try {
// Start the search
$fut = $client->startSearch($req);
// Retrieve the result
return $fut->get();
} catch (Pex\Error $err) {
// Rethrow the error if it's not retryable
if (!array_search($err->getCode(), $retryableCodes)) {
throw $err;
}
// Log the error
echo $err, "\n";
echo "retrying lookup...\n";
// Sleep for 1s or use exponential backoff
sleep(1);
// Retry the lookup
continue;
}
}
}
main();main.js
const pex = require("pex-sdk");
const CLIENT_ID = "#YOUR_CLIENT_ID_HERE";
const CLIENT_SECRET = "#YOUR_CLIENT_SECRET_HERE";
const INPUT_FILE = "/path/to/file.mp3";
async function main() {
// Initialize and authenticate the client
let client = new pex.PexSearchClient(CLIENT_ID, CLIENT_SECRET)
// Connect to the PexSearch server. This operation is asynchronous and
// returns a promise, just like most operations in this package.
await client.connect()
// Create an audio fingerprint from input file
let ft = await client.fingerprintFile(INPUT_FILE, [pex.AUDIO])
// Perform an identify music search and await the result
let result = await doLookup(client, {
fingerprint: ft,
type: pex.IDENTIFY_MUSIC,
})
// Pretty print the result
console.log(JSON.stringify(result, null, 2))
}
async function doLookup(client, req) {
// These errors are outside of the client's
// control and often resolve after retrying
let retryableCodes = [
pex.Error.DEADLINE_EXCEEDED,
pex.Error.INTERNAL_ERROR,
pex.Error.LOOKUP_FAILED,
pex.Error.LOOKUP_TIMED_OUT,
]
while(true) {
try {
// Start the lookup and await the result
return await client.startSearch(req)
} catch(err) {
// Rethrow the error if it's not retryable
if (!retryableCodes.includes(err.code)) {
throw err
}
// Log the error
console.log(err)
console.log("retrying lookup...")
// Sleep for 1s or use exponential backoff
await new Promise(r => setTimeout(r, 1000))
// Retry the lookup
continue
}
}
}
main()Last updated