您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 近距離通訊實作:用 Multipeer Connectivity 打造可傳文字、圖片與語音的聊天 App

編輯:iOS 開發綜合

很多人把這個題目叫做「iOS 藍牙開發」,但嚴格說來,真正在 iOS 上做裝置對裝置溝通,主流方案是 Multipeer Connectivity 框架。它會自動依環境挑選可用的實體通道(藍牙、Wi-Fi 直連、乙太網路),開發者只需面對統一的 API。本文用一個聊天 demo 走過完整流程。

先搞懂五個關鍵類別

  • MCAdvertiserAssistant:負責「讓別人找得到我」。它會接收並處理對方的連線請求,沒有回呼,直接彈出系統預設提示框並完成連線。
  • MCNearbyServiceAdvertiser:同樣負責廣播自己,但會透過 delegate 回呼告知「有人想連你」,因此可以自訂提示框與連線處理邏輯。
  • MCNearbyServiceBrowser:負責搜尋附近的裝置,並可對搜到的對象發出加入 session 的邀請。
  • MCPeerID:代表一個使用者(裝置)。
  • MCSession:管理整場連線會議的通訊,所有資料、資源、串流的收發都透過它。

實際的資料傳輸有三種型態:資料(Data)適合文字與小檔案、資源(Resource)適合圖片這類較大的檔案並可回報進度、串流(Stream)適合連續性的內容如錄音。

整體結構

把 Multipeer 相關的一切收攏到一個 BlueSessionManager 類別中,對外只暴露 block 形式的回呼。視圖控制器則完全不接觸 MCSession 的細節,只負責畫面與呼叫 manager 的方法。這是讓這類通訊功能可維護的關鍵。

一、BlueSessionManager 介面

#import <Foundation/Foundation.h>
@import MultipeerConnectivity;

@interface BlueSessionManager : NSObject

@property (strong, nonatomic, readonly) NSArray *connectedPeers;
@property (strong, nonatomic, readonly) MCSession *session;
@property (nonatomic, readonly, getter = isConnected) BOOL connected;
@property (strong, nonatomic) NSDictionary *discoveryInfo;   // 發現裝置時附帶的資訊
@property (strong, nonatomic, readonly) MCPeerID *firstPeer; // 第一個連上的使用者

/// 服務類型,建議命名為 tjl_appname 這種短字串
@property (strong, nonatomic) NSString *serviceType;

- (instancetype)initWithDisplayName:(NSString *)displayName;

// 廣播自己
- (void)advertiseForBrowserViewController;
- (void)advertiseForProgrammaticDiscovery;

// 搜尋別人
- (void)browseForProgrammaticDiscovery;
- (void)browseWithControllerInViewController:(UIViewController *)controller
                                   connected:(void (^)(void))connected
                                    canceled:(void (^)(void))cancelled;

// 收發資料
- (NSError *)sendDataToAllPeers:(NSData *)data;
- (NSError *)sendData:(NSData *)data toPeers:(NSArray *)peers;
- (void)receiveDataOnMainQueue:(BOOL)mainQueue block:(void (^)(NSData *data, MCPeerID *peer))dataBlock;

// 收發資源(圖片等)
- (NSProgress *)sendResourceWithName:(NSString *)name atURL:(NSURL *)url
                              toPeer:(MCPeerID *)peer
                            complete:(void (^)(NSError *error))compelete;
- (void)receiveFinalResourceOnMainQueue:(BOOL)mainQueue
                               complete:(void (^)(NSString *name, MCPeerID *peer,
                                                  NSURL *url, NSError *error))block;

// 收發串流(錄音等)
- (NSOutputStream *)streamWithName:(NSString *)name toPeer:(MCPeerID *)peerID
                             error:(NSError * __autoreleasing *)error;
- (void)didReceiveStreamFromPeer:(void (^)(NSInputStream *stream, MCPeerID *peer,
                                          NSString *streamName))streamBlock;

// 狀態
- (void)peerConnectionStatusOnMainQueue:(BOOL)mainQueue
                                  block:(void (^)(MCPeerID *peer, MCSessionState state))status;
- (void)connectToPeer:(BOOL)connect;
- (void)disconnectSession;
- (void)stopAdvertising;
- (void)stopBrowsing;

@end

二、BlueSessionManager 實作

#import "BlueSessionManager.h"
#define ServiceType @"MyService"

@interface BlueSessionManager () <MCNearbyServiceAdvertiserDelegate,
                                MCBrowserViewControllerDelegate>

@property (strong, nonatomic) MCSession *currentSession;
@property (strong, nonatomic) MCNearbyServiceAdvertiser *advertiser;
@property (strong, nonatomic) MCAdvertiserAssistant *advertisingAssistant;
@property (strong, nonatomic) MCNearbyServiceBrowser *browser;
@property (strong, nonatomic) MCPeerID *peerID;

// 對外回呼用的 block
@property (nonatomic, copy) void (^receiveDataBlock)(NSData *data, MCPeerID *peer);
@property (nonatomic, copy) void (^finalResource)(NSString *name, MCPeerID *peer,
                                                 NSURL *url, NSError *error);
@property (nonatomic, copy) void (^streamBlock)(NSInputStream *stream, MCPeerID *peer,
                                               NSString *streamName);
@property (nonatomic, copy) void (^connectionStatus)(MCPeerID *peer, MCSessionState state);
@property (nonatomic, copy) void (^invitationHandler)(BOOL connect, MCSession *session);
@property (nonatomic, copy) void (^inviteBlock)(MCPeerID *peer, NSData *context);
@property (nonatomic, copy) void (^browserConnected)(void);
@property (nonatomic, copy) void (^browserCancelled)(void);

@end


@implementation BlueSessionManager

#pragma mark - 初始化自己

- (instancetype)initWithDisplayName:(NSString *)displayName {
    return [self initWithDisplayName:displayName
                     securityIdentity:nil
                 encryptionPreferences:MCEncryptionNone
                           serviceType:ServiceType];
}

- (instancetype)initWithDisplayName:(NSString *)displayName
                   securityIdentity:(NSArray *)security
              encryptionPreferences:(MCEncryptionPreference)preference
                        serviceType:(NSString *)type {
    self = [super init];
    if (!self) { return nil; }

    self.peerID = [[MCPeerID alloc] initWithDisplayName:displayName];
    self.currentSession = [[MCSession alloc] initWithPeer:self.peerID
                                          securityIdentity:security
                                      encryptionPreference:preference];
    self.session.delegate = self;
    self.serviceType = type;
    return self;
}

#pragma mark - 廣播自己

- (void)advertiseForBrowserViewControllerWithDiscoveryInfo:(NSDictionary *)info {
    self.advertiser = [[MCNearbyServiceAdvertiser alloc] initWithPeer:self.peerID
                                                        discoveryInfo:info
                                                          serviceType:self.serviceType];
    self.advertiser.delegate = self;
    [self.advertiser startAdvertisingPeer];
}

- (void)advertiseForProgrammaticDiscoveryWithDiscoveryInfo:(NSDictionary *)info {
    self.advertisingAssistant = [[MCAdvertiserAssistant alloc] initWithServiceType:self.serviceType
                                                                    discoveryInfo:info
                                                                          session:self.session];
    [self.advertisingAssistant start];
}

// 收到邀請時,把 handler 存起來,交給外部決定要不要接受
- (void)advertiser:(MCNearbyServiceAdvertiser *)advertiser
               didReceiveInvitationFromPeer:(MCPeerID *)peerID
                             withContext:(NSData *)context
                        invitationHandler:(void (^)(BOOL, MCSession *))invitationHandler {
    self.invitationHandler = [invitationHandler copy];
    if (self.inviteBlock) { self.inviteBlock(peerID, context); }
}

- (void)connectToPeer:(BOOL)connect {
    self.invitationHandler(connect, self.session);
}

#pragma mark - 搜尋別人

- (void)browseForProgrammaticDiscovery {
    self.browser = [[MCNearbyServiceBrowser alloc] initWithPeer:self.peerID
                                                    serviceType:self.serviceType];
    self.browser.delegate = self;
    [self.browser startBrowsingForPeers];
}

- (void)browser:(MCNearbyServiceBrowser *)browser
      foundPeer:(MCPeerID *)peerID
withDiscoveryInfo:(NSDictionary *)info {
    if (self.didFindPeerBlock) { self.didFindPeerBlock(peerID, info); }
}

// 用系統自帶的搜尋介面,省去自己畫 UI
- (void)browseWithControllerInViewController:(UIViewController *)controller
                                   connected:(void (^)(void))connected
                                    canceled:(void (^)(void))cancelled {
    self.browserConnected = [connected copy];
    self.browserCancelled = [cancelled copy];

    MCBrowserViewController *browser =
        [[MCBrowserViewController alloc] initWithServiceType:self.serviceType
                                                     session:self.session];
    browser.delegate = self;
    [controller presentViewController:browser animated:YES completion:nil];
}

- (void)browserViewControllerDidFinish:(MCBrowserViewController *)browserViewController {
    [browserViewController dismissViewControllerAnimated:YES completion:^{
        if (self.browserConnected) { self.browserConnected(); }
    }];
}

- (void)browserViewControllerWasCancelled:(MCBrowserViewController *)browserViewController {
    [browserViewController dismissViewControllerAnimated:YES completion:^{
        if (self.browserCancelled) { self.browserCancelled(); }
    }];
}

#pragma mark - MCSessionDelegate

// 收到普通資料
- (void)session:(MCSession *)session
didReceiveData:(NSData *)data
      fromPeer:(MCPeerID *)peerID {
    if (self.receiveDataBlock) { self.receiveDataBlock(data, peerID); }
}

// 收到串流
- (void)session:(MCSession *)session
didReceiveStream:(NSInputStream *)stream
       withName:(NSString *)streamName
       fromPeer:(MCPeerID *)peerID {
    if (self.streamBlock) { self.streamBlock(stream, peerID, streamName); }
}

// 資源開始接收(可回報進度)
- (void)session:(MCSession *)session
didStartReceivingResourceWithName:(NSString *)resourceName
         fromPeer:(MCPeerID *)peerID
     withProgress:(NSProgress *)progress {
    // 可在此更新進度條 UI
}

// 資源接收完成
- (void)session:(MCSession *)session
didFinishReceivingResourceWithName:(NSString *)resourceName
         fromPeer:(MCPeerID *)peerID
            atURL:(NSURL *)localURL
        withError:(NSError *)error {
    if (self.finalResource) { self.finalResource(resourceName, peerID, localURL, error); }
}

// 連線狀態變化:兩台裝置一旦連上就會形成一個 session
- (void)session:(MCSession *)session
           peer:(MCPeerID *)peerID
 didChangeState:(MCSessionState)state {
    if (self.connectionStatus) { self.connectionStatus(peerID, state); }
}

#pragma mark - 送出資料與資源

- (NSError *)sendDataToAllPeers:(NSData *)data {
    NSError *error;
    [self.session sendData:data
                   toPeers:self.session.connectedPeers
                  withMode:MCSessionSendDataReliable
                     error:&error];
    return error;
}

- (NSProgress *)sendResourceWithName:(NSString *)name atURL:(NSURL *)url
                              toPeer:(MCPeerID *)peer
                            complete:(void (^)(NSError *error))compelete {
    return [self.session sendResourceAtURL:url
                                  withName:name
                                    toPeer:peer
                     withCompletionHandler:compelete];
}

#pragma mark - 收尾

- (void)disconnectSession  { [self.session disconnect]; }
- (void)stopAdvertising   { [self.advertiser stopAdvertisingPeer]; [self.advertisingAssistant stop]; }
- (void)stopBrowsing      { [self.browser stopBrowsingForPeers]; }

- (BOOL)isConnected {
    return self.session.connectedPeers && self.session.connectedPeers.count > 0;
}

- (MCSession *)session    { return self.currentSession; }
- (MCPeerID *)firstPeer   { return self.session.connectedPeers.firstObject; }

@end

三、視圖控制器:把 manager 的回呼接到畫面

- (void)makeBlueData {
    // 在 block 中使用弱引用,避免循環參考
    __weak typeof(self) weakSelf = self;

    self.datasource = [NSMutableArray arrayWithCapacity:0];
    self.sessionManager = [[BlueSessionManager alloc]
        initWithDisplayName:[NSString stringWithFormat:@"%@", [[UIDevice currentDevice] name]]];

    // 連線狀態
    [self.sessionManager peerConnectionStatusOnMainQueue:YES block:^(MCPeerID *peer, MCSessionState state) {
        if (state == MCSessionStateConnected) {
            UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"已經連接"
                                                           message:[NSString stringWithFormat:@"現在連接 %@ 了!", peer.displayName]
                                                          delegate:nil
                                                 cancelButtonTitle:nil
                                                 otherButtonTitles:@"知道了", nil];
            [alert show];
        }
    }];

    // 收到文字
    [self.sessionManager receiveDataOnMainQueue:YES block:^(NSData *data, MCPeerID *peer) {
        __strong typeof(weakSelf) strongSelf = weakSelf;
        ChatItem *item = [[ChatItem alloc] init];
        item.isSelf = NO;
        item.states = textStates;
        item.content = [NSKeyedUnarchiver unarchiveObjectWithData:data];
        [strongSelf.datasource addObject:item];
        [strongSelf insertTheTableToButtom];
    }];

    // 收到圖片資源
    [self.sessionManager receiveFinalResourceOnMainQueue:YES complete:^(NSString *name, MCPeerID *peer, NSURL *url, NSError *error) {
        __strong typeof(weakSelf) strongSelf = weakSelf;
        ChatItem *item = [[ChatItem alloc] init];
        item.isSelf = NO;
        item.states = picStates;
        item.content = name;
        item.picImage = [UIImage imageWithData:[NSData dataWithContentsOfURL:url]];
        [strongSelf.datasource addObject:item];
        [strongSelf insertTheTableToButtom];
    }];

    // 收到串流
    [self.sessionManager didReceiveStreamFromPeer:^(NSInputStream *stream, MCPeerID *peer, NSString *streamName) {
        __strong typeof(weakSelf) strongSelf = weakSelf;
        strongSelf.inputStream = stream;
        strongSelf.inputStream.delegate = strongSelf;
        [strongSelf.inputStream scheduleInRunLoop:[NSRunLoop mainRunLoop] forMode:NSDefaultRunLoopMode];
        [strongSelf.inputStream open];
    }];
}

四、三種傳輸方式在實務上的差別

文字:用 sendData

- (void)sendWeNeedNews {
    if (!self.sessionManager.isConnected) {
        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"藍牙已經斷開了,請重新連接!"
                                                       message:nil delegate:nil
                                             cancelButtonTitle:nil otherButtonTitles:@"知道了", nil];
        [alert show];
        return;
    }
    if ([self.sendTextView.text isEqualToString:@""]) { return; }

    ChatItem *item = [[ChatItem alloc] init];
    item.isSelf = YES;
    item.states = textStates;
    item.content = self.sendTextView.text;
    [self.datasource addObject:item];
    [self insertTheTableToButtom];

    NSData *data = [NSKeyedArchiver archivedDataWithRootObject:self.sendTextView.text];
    NSError *error = [self.sessionManager sendDataToAllPeers:data];
    if (error) { NSLog(@"%@", error); }

    [self returnTheNewBack];
}

用 return 鍵送出的小技巧是實作 textView:shouldChangeTextInRange:replacementText:,攔截換行字元後直接送出並回傳 NO。

圖片:用 sendResource

先從相簿或相機取得 UIImage,轉成 NSData 後寫入 Documents 取得檔案路徑,再呼叫:

- (void)sendAsResource:(NSString *)path {
    NSString *name = [NSString stringWithFormat:@"%@ForPic", [[UIDevice currentDevice] name]];
    NSURL *url = [NSURL fileURLWithPath:path];
    NSProgress *progress = [self.sessionManager sendResourceWithName:name
                                                             atURL:url
                                                            toPeer:self.sessionManager.firstPeer
                                                          complete:^(NSError *error) {
        if (!error) { NSLog(@"finished sending resource"); }
    }];
    NSLog(@"%@", @(progress.fractionCompleted));
}

語音:用 sendStream

錄音完成後把檔案轉成 NSData,透過 NSOutputStream 寫出;接收端則在 NSStreamEventEndEncountered 時把陸續收到的 bytes 攏集成完整的 NSData。

- (void)stream:(NSStream *)aStream handleEvent:(NSStreamEvent)eventCode {
    if (eventCode == NSStreamEventHasBytesAvailable) {
        // 有可讀位元組:把收到的資料一點一點累積起來
        NSInputStream *input = (NSInputStream *)aStream;
        uint8_t buffer[1024];
        NSInteger length = [input read:buffer maxLength:1024];
        [self.streamData appendBytes:(const void *)buffer length:(NSUInteger)length];

    } else if (eventCode == NSStreamEventHasSpaceAvailable) {
        // 輸出端可寫:把整份錄音送出去
        NSData *data = [self getVideoStremData];
        NSOutputStream *output = (NSOutputStream *)aStream;
        [output write:data.bytes maxLength:data.length];
        [output close];

    } else if (eventCode == NSStreamEventEndEncountered) {
        // 流結束:此時 self.streamData 才是完整檔案,也是做清理的好位置
        ChatItem *item = [[ChatItem alloc] init];
        item.isSelf = NO;
        item.states = videoStates;
        item.recordData = self.streamData;
        [self.datasource addObject:item];
        [self insertTheTableToButtom];

        [aStream close];
        [aStream removeFromRunLoop:[NSRunLoop mainRunLoop] forMode:NSDefaultRunLoopMode];
        if ([aStream isKindOfClass:[NSInputStream class]]) { self.streamData = nil; }

    } else if (eventCode == NSStreamEventErrorOccurred) {
        NSLog(@"error");
    }
}

五、錄音相關設定

錄音前必須先設定 AVAudioSession 的 category 為 PlayAndRecord,否則錄完無法立即播放。錄音格式與取樣率的設定如下:

- (void)setAudioSession {
    AVAudioSession *audioSession = [AVAudioSession sharedInstance];
    [audioSession setCategory:AVAudioSessionCategoryPlayAndRecord error:nil];
    [audioSession setActive:YES error:nil];
}

- (NSDictionary *)getAudioSetting {
    NSMutableDictionary *dicM = [NSMutableDictionary dictionary];
    [dicM setObject:@(kAudioFormatLinearPCM) forKey:AVFormatIDKey];
    [dicM setObject:@(8000) forKey:AVSampleRateKey];        // 8000 為電話取樣率
    [dicM setObject:@(1)     forKey:AVNumberOfChannelsKey]; // 單聲道
    [dicM setObject:@(8)     forKey:AVLinearPCMBitDepthKey];
    [dicM setObject:@(YES)   forKey:AVLinearPCMIsFloatKey];
    return dicM;
}

// 監控音量波形
- (void)audioPowerChange {
    [self.audioRecorder updateMeters];
    float power = [self.audioRecorder averagePowerForChannel:0];   // 範圍 -160 ~ 0
    CGFloat progress = (1.0 / 160.0) * (power + 160.0);
    [self.audioPower setProgress:progress];
}

六、Cell 的排版邏輯

聊天介面的 cell 需要同時處理「自己傳的/對方傳的」與「文字/圖片/語音」的組合,實作上是在 cellForRowAtIndexPath 中依 isSelf 與 states 切換各子視圖的 hidden 狀態,並依 boundingRectWithSize: 算出的文字高度動態調整氣泡 frame。

要注意的是:cell 有復用機制,所以每個分支都要把所有相關子視圖的顯示狀態明確設定一次,否則會出現「上一筆的圖片殘留在下一筆」這類典型的復用 bug。

七、實測時別忽略的事

只能真機測試。Multipeer Connectivity 需要實體無線硬體,模擬器無法驗證,所以這個 demo 沒有模擬器截圖可看。

先做連線檢查。以上三種傳輸方式在送出前都應該檢查 isConnected,否則呼叫會直接失敗。

注意 block 的循環參考。manager 持有 block、block 又捕捉 controller,一律用 __weak 搭配 __strong 的標準寫法處理。

記得清理。在 dealloc 中呼叫 disconnectSession、stopAdvertising、stopBrowsing,並移除 NSNotificationCenter 的觀察者,避免裝置在畫面關閉後仍然持續廣播。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved