Anleitung zum Text-Chat (iOS)

Übersicht

Über die OpenTok-Signalisierungs-API können Clients Textnachrichten an andere Clients senden, die mit der OpenTok-Sitzung verbunden sind. Sie können eine Signalisierungsnachricht an einen bestimmten Client senden oder eine Nachricht an alle mit der Sitzung verbundenen Clients.

Einrichten Ihres Projekts

So führen Sie diese Anleitung durch:

  1. OpenTok klonen iOS-Beispiel-Apps Repo auf GitHub:

    git clone https://github.com/opentok/opentok-ios-sdk-samples.git

  2. Im Terminal, cd in das Unterverzeichnis „Signaling“ des Projekts und führen Sie anschließend folgenden Befehl aus: pod install.

  3. Öffnen Sie Ihr Projekt in Xcode, indem Sie auf die neue Datei „Signaling.xcworkspace“ im Verzeichnis „Signaling“ doppelklicken.

  4. Öffnen Sie die Datei „Config.h“ und legen Sie die SAMPLE_SERVER_BASE_URL Zeichenkette an die Basis-URL des Servers, der die Lernen mit OpenTok PHP Projekt. Dieser Server stellt der iOS-Beispiel-App OpenTok-Sitzungs-IDs und -Token zur Verfügung. Weitere Informationen finden Sie unter Einrichten Ihres Servers.

Um Text-Chat-Nachrichten zwischen zwei Clients auszutauschen, die mit der OpenTok-Sitzung verbunden sind, können Sie die App im Xcode-Simulator und auf einem iOS-Gerät ausführen.

Den Code erkunden

Das Archivierungsbeispiel baut auf dem Beispiel für einen einfachen Video-Chat, und es bietet folgende Funktionen:

  • Tippen Sie in das Eingabefeld für den Text-Chat (mit der Beschriftung „Hier tippen, um eine Chat-Nachricht zu senden.“), geben Sie eine Text-Chat-Nachricht ein und tippen Sie auf die Eingabetaste.

    Die Text-Chat-Nachricht wird an andere Clients gesendet, die mit der OpenTok-Sitzung verbunden sind. Sie können auch eine Chat-Nachricht von den anderen Clients an den iOS-Client senden.

Wenn der Benutzer Text in das Eingabefeld des Text-Chats eingibt, wird die [self sendChatMessage:] Methode aufgerufen wird:

- (void) sendChatMessage
{
    OTError* error = nil;
    [_session signalWithType:@"chat"
                      string:_chatInputTextField.text
                  connection:nil error:&error];
    if (error) {
        NSLog(@"Signal error: %@", error);
    } else {
        NSLog(@"Signal sent: %@", _chatInputTextField.text);
    }
    _chatTextInputView.text = @"";
}

Diese Methode ruft die [OTSession signalWithType:string:connection:] Methode. Diese Methode sendet eine Nachricht an die mit der OpenTok-Sitzung verbundenen Clients. Jedes Signal wird durch ein type eine Zeichenfolge, die den Nachrichtentyp angibt (in diesem Fall „Chat“), und eine Zeichenfolge, die den Nachrichtentext enthält.

Wenn ein anderer Client, der mit der Sitzung verbunden ist, eine Nachricht sendet, führt die Implementierung der [OTSessionDelegate session:receivedSignalType:fromConnection:withString:] Methode aufgerufen wird:

- (void)session:(OTSession*)session receivedSignalType:(NSString*)type fromConnection:(OTConnection*)connection withString:(NSString*)string {
    NSLog(@"Received signal %@", string);
    Boolean fromSelf = NO;
    if ([connection.connectionId isEqualToString:session.connection.connectionId]) {
        fromSelf = YES;
    }
    [self logSignalString:string fromSelf:fromSelf];
}

Diese Methode prüft, ob das Signal vom lokalen iOS-Client oder von einem anderen mit der Sitzung verbundenen Client gesendet wurde:

Boolean fromSelf = NO;
if ([connection.connectionId isEqualToString:session.connection.connectionId]) {
    fromSelf = YES;
}

Die session Das Argument stellt das OTSession-Objekt Ihres Clients dar. Das OTSession-Objekt verfügt über ein connection Immobilie mit einem connectionId Eigenschaft. Die connection Das Argument steht für die Verbindung des Clients, der die Nachricht gesendet hat. Stimmen diese überein, wurde das Signal von der lokalen iOS-App gesendet.

Die Methode ruft die [self logSignalString:] Methode, die den Nachrichtentext in der Textansicht für empfangene Chat-Nachrichten anzeigt.

Diese App nutzt die OpenTok-Signalisierungs-API zur Implementierung des Text-Chats. Sie können die Signalisierungs-API jedoch auch nutzen, um Nachrichten an andere Clients (einzeln oder gemeinsam) zu senden, die mit der Sitzung verbunden sind.

Herzlichen Glückwunsch! Du hast das Text-Chat-Tutorial für iOS abgeschlossen.
Du kannst den Code, den du hier entwickelt hast, weiter ausprobieren und anpassen oder dir die Nächste Schritte unten. Weitere Informationen zur Signalübertragung finden Sie im OpenTok-Entwicklerhandbuch zur Signalisierung.

Nächste Schritte

Wenn Sie hier fertig sind, können Sie Ihre OpenTok-Application mit diesen hilfreichen Ressourcen weiter ausbauen und verbessern: