AudioShareSDK

KO | EN

gitlite — search

#python #hacktoberfest #typescript #go #android #machine-learning #rust #linux #awesome #cli #kubernetes #ios #openai #open-source

(★ 36)

Export soundfiles from your own app into the AudioShare app for iPhone, iPad and iPod touch.

AudioShareSDK 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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 info@kymatica.com so that I can add your app to the list of implementing apps on http://kymatica.com/audioshare

http://kymatica.com

AudioShareSDK

AudioShareSDK 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AudioShareSDK

AudioShareSDK 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README