QuietModemKit 使用教程

QuietModemKit 使用教程

QuietModemKitiOS framework for the Quiet Modem (data over sound)项目地址:https://gitcode.com/gh_mirrors/qu/QuietModemKit

1、项目介绍

QuietModemKit 是一个用于 iOS 平台的第三方库，它允许通过可听声或近似超声波传输数据。该库的核心库 quiet 是用 C 语言编写的，可以跨平台使用。QuietModemKit 通过数字信号处理（DSP）技术，实现数据的编码和解码，从而通过扬声器发出信号，并通过麦克风接收信号来传输数据。

2、项目快速启动

安装

首先，确保你已经安装了 cmake，然后通过 Carthage 来安装 QuietModemKit：

brew install cmake
echo 'github "quiet/QuietModemKit"' >> Cartfile
carthage update

示例代码

发送端

#import <QuietModemKit/QuietModemKit.h>

int main(int argc, char * argv[]) {
    QMTransmitterConfig *txConf = [[QMTransmitterConfig alloc] initWithKey:@"ultrasonic-experimental"];
    QMFrameTransmitter *tx = [[QMFrameTransmitter alloc] initWithConfig:txConf];
    NSString *frame_str = @"Hello World";
    NSData *frame = [frame_str dataUsingEncoding:NSUTF8StringEncoding];
    [tx send:frame];
    CFRunLoopRun();
    [tx close];
    return 0;
}

接收端

#import <QuietModemKit/QuietModemKit.h>

static QMFrameReceiver *rx;
void (^recv_callback)(NSData*) = ^(NSData *frame){
    printf("%s\n", [frame bytes]);
};

void (^request_callback)(BOOL) = ^(BOOL granted){
    QMReceiverConfig *rxConf = [[QMReceiverConfig alloc] initWithKey:@"ultrasonic-experimental"];
    rx = [[QMFrameReceiver alloc] initWithConfig:rxConf];
    [rx setReceiveCallback:recv_callback];
};

int main(int argc, char * argv[]) {
    [AVAudioSession sharedInstance].recordPermission == AVAudioSessionRecordPermissionGranted ? request_callback(YES) : [[AVAudioSession sharedInstance] requestRecordPermission:request_callback];
    CFRunLoopRun();
    [rx close];
    return 0;
}

3、应用案例和最佳实践

应用案例

QuietModemKit 可以用于需要在无网络环境下传输数据的场景，例如：

• 在会议室中，通过声音传输文件或数据。
• 在展览会中，通过声音传输展品信息。
• 在教育场景中，通过声音传输习题或答案。

最佳实践

• 选择合适的配置文件：根据实际需求选择合适的配置文件，例如 ultrasonic-experimental 适用于超声波传输。
• 处理权限请求：确保在应用启动时请求麦克风和扬声器的权限。
• 优化传输效率：根据实际场景调整传输速率和编码方式，以达到最佳传输效率。

4、典型生态项目

QuietModemKit 可以与其他 iOS 开发库和工具结合使用，例如：

• RxSwift：用于处理异步事件和数据流。
• Carthage：用于依赖管理，简化库的集成和更新。
• AVFoundation：用于处理音频输入和输出，与 QuietModemKit 结合使用可以实现更复杂的音频处理功能。

通过这些生态项目的结合，可以进一步扩展 QuietModemKit 的功能和应用场景。

QuietModemKitiOS framework for the Quiet Modem (data over sound)项目地址:https://gitcode.com/gh_mirrors/qu/QuietModemKit