composer require thelemon2020/nativephp-shazamkit
php artisan native:plugin:register thelemon2020/nativephp-shazamkit
php artisan native:plugin:validate

php artisan native:install --force

use Thelemon2020\NativephpShazamkit\Facades\ShazamKit;
 
// Arms the mic and starts matching. Returns only whether the session
// started — the actual result arrives later as an event (see Events below).
ShazamKit::startListening();
 
// Cancel an in-progress listen. Call this when the user navigates away
// from the screen — a session left running keeps the mic (and battery) active.
ShazamKit::stopListening();
 
// iOS only — re-save the last match to the user's Shazam library without
// listening again. See the AddedToLibrary / LibraryError events below.
ShazamKit::addToLibrary();

import { shazamKit } from '@thelemon2020/nativephp-shazamkit';
 
// Arms the mic and starts matching. Resolves once the session has
// started — not once a match is found.
await shazamKit.startListening();
 
// Cancel an in-progress listen.
await shazamKit.stopListening();
 
// iOS only — re-save the last match without listening again.
await shazamKit.addToLibrary();

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\MatchFound;
 
#[On(MatchFound::class)]
public function onMatchFound(string $title, string $artist, ?string $artworkUrl, ?string $appleMusicUrl, ?string $isrc, ?string $shazamId)
{
    // ...
}

import { On } from '#nativephp';
import { ShazamKitEvents } from '@thelemon2020/nativephp-shazamkit';
 
On(ShazamKitEvents.MatchFound, (payload) => {
    // { title, artist, artworkUrl, appleMusicUrl, isrc, shazamId }
});

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\NoMatch;
 
#[On(NoMatch::class)]
public function onNoMatch() { /* ... */ }

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\ListeningError;
 
#[On(ListeningError::class)]
public function onListeningError(string $reason, ?string $message) { /* ... */ }

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\PermissionDenied;
 
#[On(PermissionDenied::class)]
public function onPermissionDenied() { /* ... */ }

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\AddedToLibrary;
 
#[On(AddedToLibrary::class)]
public function onAddedToLibrary() { /* "Saved to your Shazam library" */ }

import { On } from '#nativephp';
import { ShazamKitEvents } from '@thelemon2020/nativephp-shazamkit';
 
On(ShazamKitEvents.AddedToLibrary, () => {
    // "Saved to your Shazam library"
});

use Native\Mobile\Attributes\On;
use Thelemon2020\NativephpShazamkit\Events\LibraryError;
 
#[On(LibraryError::class)]
public function onLibraryError(string $reason, ?string $message) { /* "Couldn't save that" */ }

import { On } from '#nativephp';
import { ShazamKitEvents } from '@thelemon2020/nativephp-shazamkit';
 
On(ShazamKitEvents.LibraryError, (payload) => {
    // "Couldn't save that" — payload.reason is "no_match" or "native_error"
});

php artisan vendor:publish --tag=shazamkit-config

SHAZAMKIT_TEAM_ID=...
SHAZAMKIT_KEY_ID=...
SHAZAMKIT_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----..."

use Thelemon2020\NativephpShazamkit\Contracts\DeveloperTokenResolver;
 
class MyBackendTokenResolver implements DeveloperTokenResolver
{
    public function resolve(): string
    {
        // Call your own authenticated backend endpoint, which holds the
        // Apple Media Services key server-side and signs the JWT there.
        return Http::withToken(config('services.mybackend.token'))
            ->get(config('services.mybackend.url').'/shazamkit/developer-token')
            ->throw()
            ->json('token');
    }
}

// In your app's own service provider — Laravel registers app providers
// after package-discovered providers like this plugin's, so this
// overrides the default binding:
$this->app->singleton(DeveloperTokenResolver::class, MyBackendTokenResolver::class);