AudioShare SDK

This SDK will let you export audio to, or import audio from, the AudioShare app for iPhone, iPad and iPod touch.

AudioShare - audio document manager, is a simple tool to manage all your sounds in a single place on your device, with easy transferring of sounds between AudioShare and other apps or your computer. Read more about it here: http://kymatica.com/audioshare

Usage

First, copy the files AudioShareSDK.h and AudioShareSDK.m into your project.

Don't forget to import the header:

#import "AudioShareSDK.h"

You also need to add the MobileCoreServices framework to your project.

iOS 9 Support

Since iOS 9, apps must whitelist URL schemes to allow querying them with canOpenURL, which this SDK does.

For your app to work with this SDK on iOS 9, you must add the following entry to your Info.plist:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>audioshare.import</string>
    <string>audiosharecmd</string>
</array>

You must also add the MobileCoreServices.framework to your project. Otherwise, your build will fail with errors stating that _kUTTypeAudio is an undefined symbol.

AudioShare SDK now uses ARC

If your project is not ARC-enabled, you'll need to enable ARC for AudioShareSDK.m:

1. Select the project in the left-hand Project Navigator tree.

2. Click on the "Build Phases" tab at the top.

3. Click on "Compile Sources" category to show the enclosed files.

4. Select to highlight the AudioShareSDK.m file.

5. Double-click on the right-hand side of the selected row, under the "Compiler Flags" column.

6. Type: -fobjc-arc into the field, and press the return key to commit the new compiler flag.

Export to AudioShare

The typical usage is to have a button or menu item labelled "Export to AudioShare" that transfers a soundfile from your own app into AudioShare. Just put the following line in the code that gets called when the user taps the button:

[[AudioShare sharedInstance] addSoundFromPath:thePathToYourFile withName:@"My Sound"];

In case you have your sound in memory, you can send an NSData instead:

[[AudioShare sharedInstance] addSoundFromData:yourSoundData withName:@"My Sound"];

These methods will check that a recent enough version of AudioShare is installed, and otherwise present the user with the option to view the app on the App Store. If AudioShare was installed, it will open AudioShare and import the audio, and return YES if successfull.

If AudioShare was not installed, it will just copy the audio to the general pasteboard.

Import from AudioShare

Since AudioShare version 2.5, you can also easily import sound from AudioShare into your own app.

1. First, declare a new URL type in your Info.plist with the scheme yourAppName.audioshare. Replace yourAppName with a unique name for your app, but keep the .audioshare suffix.

2. Then, in your app delegates openURL handler method, call checkPendingImport:withBlock: to handle the import:

    if([[AudioShare sharedInstance] checkPendingImport:url withBlock:^(NSString *path) {
   
      // Move the temporary file into our Documents folder
      NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
      NSString *documentsDirectory = [paths objectAtIndex:0];
      NSString *destination = [documentsDirectory stringByAppendingPathComponent:[path lastPathComponent]];
      [[NSFileManager defaultManager] moveItemAtPath:path toPath:destination error:nil];
   
      // Load the imported file
      [mySoundEngine loadSample:destination];
   
    }]) {
      return YES;
    }
   

3. To initiate the import from your app, add a button named "Import from AudioShare" which simply calls:

    [[AudioShare sharedInstance] initiateSoundImport];
   

This will launch AudioShare (if version 2.5 or later is installed), which will display an "Import into app: YourAppName" button. When the user taps this button in AudioShare, it will launch your application where the call to checkPendingImport:withBlock: will grab the imported soundfile.

If AudioShare was not installed, it will just paste audio from the general pasteboard, and then call your callback URL. The pasted audio will thus be handled in your checkPendingImport as usual. The filename will be "PastedAudio" with suitable path extension added depending on the file type.

Multithreading

The addSoundFrom* and initiateSoundImport methods should always be called from the main thread. If you need to call it from another thread, you must wrap the call in a block dispatched on the main thread. Example:

    dispatch_async(dispatch_get_main_queue(), ^(void) {
        [[AudioShare sharedInstance] addSoundFromURL:theUrlToYourFile
                                            withName:@"My Sound"];
    });

Supported formats

AudioShare supports all soundfile formats, bit depths and rates, that has built-in support in iOS: AIFF, AIFC, WAVE, SoundDesigner2, Next, MP3, MP2, MP1, AC3, AAC_ADTS, MPEG4, M4A, CAF, 3GP, 3GP2, AMR. Additionally, it supports standard MIDI files.

License

You are free to incorporate this code in your own application, for the purpose of launching and/or transferring sounds to/from the AudioShare app.

If you do, please drop me a message at [email protected] so that I can add your app to the list of implementing apps on http://kymatica.com/audioshare

Copyright (C)2012-2015 Jonatan Liljedahl

http://kymatica.com