SMS-Versand von Objective C
Der einfachste Weg, SMS von Objective C aus zu versenden, ist die Verwendung der integrierten HTTP/Rest-SMS-API von Ozeki SMS Gateway. Wenn Sie diese API verwenden, senden Sie SMS-Nachrichten, indem Sie eine HTTP-Post-Anfrage an das SMS-Gateway stellen. Die HTTP-Post-Anfrage enthält eine Nachricht im JSON-Format. Das SMS-Gateway sendet diese SMS an das Empfängertelefon und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.
Objective-C-Code zum Senden von SMS an Mobiltelefone
Das folgende Objective-C-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der Objective-C-Bibliothek Ozeki.Libs.Rest senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt und kann in beliebigen Projekten verwendet und modifiziert werden.
SendSms.m
#import <Foundation/Foundation.h>
#import "Ozeki.Libs.Rest.h"
int main(int argc, const char * argv[]) {
Configuration * configuration = [ [ Configuration alloc ] init];
[ configuration setUsername : @"http_user" ];
[ configuration setPassword : @"qwe123" ];
[ configuration setApiUrl : @"http://127.0.0.1:9509/api" ];
// Ersetzen Sie die IP-Adresse durch die des Computers, auf dem das SMS-Gateway läuft!
Message * msg = [ [ Message alloc ] init ];
[ msg setToAddress : @"+36201111111" ];
[ msg setText : @"Hallo Welt!" ];
MessageApi * api = [ [ MessageApi alloc ] initWithConfiguration : configuration ];
MessageSendResult * result = [ api SendMessage: msg ];
NSLog(@"%@", result);
return 0;
}
Verwendung des Objective-C-SMS-Beispiels:
Dieses Objective-C-SMS-Beispiel kann in jeder Objective-C-Core-Anwendung verwendet werden. Um es zu nutzen, müssen Sie die Header-Datei Ozeki.Libs.Rest.h und die Implementierungsdatei Ozeki.Libs.Rest.m zu Ihrem Projekt hinzufügen. Nachdem die Projektreferenz hinzugefügt wurde, müssen Sie die Direktive using Ozeki.Libs.Rest; in den Header-Bereich Ihres Objective-C-Quellcodes einfügen. Dadurch können Sie die Klassen der Ozeki.Libs.Rest-Bibliothek verwenden. Mit der Message-Klasse können Sie die SMS erstellen. Mit der MessageApi-Klasse können Sie die SMS an das SMS-Gateway senden. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.
SendSMS.m herunterladen
Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendSms.m.zip (59,6 KB)
Was befindet sich in der Datei SendSms.m.zip?
Die Datei SendSms.m.zip enthält die Bibliothek Ozeki.Libs.Rest, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Im Zip-Archiv finden Sie außerdem das SendSms-Projekt, das den Beispielcode enthält, der zeigt, wie Sie eine SMS versenden können. Dieser Beispielcode ist unten aufgeführt.
SMS-Versand von Objective C (Einfache Anleitung)
So senden Sie SMS von Objective C aus:
- Installieren Sie einen HTTP-API-Benutzer auf einem Windows-Rechner
- Aktivieren Sie "Log communication events" auf der Registerkarte "Advanced"
- Richten Sie Xcode ein
- Laden Sie die Datei SendSms.m.zip herunter und entpacken Sie sie
- Öffnen Sie die Datei SendSms.xcodeproj in Xcode
- Starten Sie die Ozeki SMS Gateway-App auf Ihrem Windows-Rechner
- Führen Sie den Objective-C-Code SendSms.m in Xcode aus
- Überprüfen Sie die Protokolle, ob die SMS gesendet wurde
Ozeki SMS Gateway installieren und einen HTTP-API-Benutzer erstellen
Um SMS von Objective C aus senden zu können, müssen Sie zunächst Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren Objective-C-Code in Visual Studio entwickeln. Nach der Installation besteht der nächste Schritt darin, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS über die Ozeki-GUI senden, um zu überprüfen, ob Ihre Mobilfunknetzverbindung funktioniert. Der letzte Schritt zur Vorbereitung Ihrer Umgebung ist die Erstellung eines HTTP-SMS-API-Benutzerkontos. Erstellen Sie einen Benutzer mit dem Benutzernamen "http_user" und dem Passwort "qwe123", damit das Beispiel ohne Änderungen funktioniert.
Nachdem die Umgebung eingerichtet ist, können Sie Ihren Objective-C-Code ausführen.
HTTP-API-URL zum Senden von SMS von Objective C aus
Um SMS von Objective C aus zu senden, muss Ihre Objective-C-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. Die API-URL wird unten angezeigt. Beachten Sie, dass die IP-Adresse (127.0.0.1) durch die IP-Adresse Ihres SMS-Gateways ersetzt werden sollte. Wenn Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die Objective-C-SMS-Anwendung läuft, kann dies 127.0.0.1 sein. Bei Installation auf einem anderen Computer sollte dies die IP-Adresse dieses Computers sein.
http://127.0.0.1:9509/api?action=rest
HTTP-Authentifizierung zum Senden von SMS aus Objective C
Um den Objective C SMS-Client zu authentifizieren, müssen Sie den Benutzernamen und das Passwort in einer base64-kodierten Zeichenkette an den Server in einer HTTP-Anfrage senden. Das verwendete Format lautet: base64(Benutzername+":"+Passwort). In Objective C können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:
NSString * username_password = [ NSString stringWithFormat : @"%@:%@", username, password ]; NSData * encode_data = [username_password dataUsingEncoding:NSUTF8StringEncoding]; NSString * username_password_encoded = [encode_data base64EncodedStringWithOptions : 0]; return [ NSString stringWithFormat : @"Basic %@", username_password_encoded ];
Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie die folgende base64-kodierte Zeichenkette: aHR0cF91c2VyOnF3ZTEyMw==. Zum Senden
HTTP-Anfrageheader zum Senden von SMS aus Objective C
Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage aufnehmen. Beachten Sie, dass wir einen Content-Type und einen Authorization-Header einfügen.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
HTTP-Anfrage zum Senden von SMS aus Objective C
Um die SMS zu übermitteln, sendet Ihre Objective C-Anwendung eine HTTP-Anfrage ähnlich der untenstehenden. Beachten Sie, dass diese Anfrage einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist eine JSON-kodierte Datenzeichenkette. Sie enthält die Empfängernummer und den Nachrichtentext.
POST /api?action=sendmsg HTTP/1.1
Connection: keep-alive
Content-Length: 332
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip, deflate
Accept-Language: en-gb
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.14:9509
User-Agent: SendSms.m (unknown version) CFNetwork/1220.1 Darwin/20.3.0
{
"messages": [
{
"is_view_report_requested": false,
"create_date": "2021-07-23T07:54:47",
"message_id": "8de52a43-b6e4-4aa9-8198-54d54f252a83",
"time_to_send": "2021-07-23T07:54:47",
"valid_until": "2021-07-30T07:54:47",
"is_submit_report_requested": false,
"to_address":"+36201111111",
"text": "Hello world!",
"is_delivery_report_requested": false
}
]
}
HTTP-Antwort, die vom Objective C SMS-Beispiel empfangen wird
Sobald das SMS-Gateway diese Anfrage empfängt, wird es eine HTTP-Antwort generieren. Die HTTP-Antwort enthält einen Statuscode, der angibt, ob die SMS-Übermittlungsanfrage erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über die Nachrichtenübermittlung liefert.
HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 22 Jul 2021 12:17:05 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
{
"http_code": 200,
"response_code": "SUCCESS",
"response_msg": "Messages queued for delivery.",
"data": {
"total_count": 1,
"success_count": 1,
"failed_count": 0,
"messages": [
{
"message_id": "8de52a43-b6e4-4aa9-8198-54d54f252a83",
"from_station": "%",
"to_address": "+36201111111",
"to_station": "%",
"text": "Hello world!",
"create_date": "2021-07-23 07:54:47",
"valid_until": "2021-07-30 07:54:47",
"time_to_send": "2021-07-23 07:54:47",
"submit_report_requested": true,
"delivery_report_requested": false,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
}
]
}
}
Verbinden Sie Ihr SMS-Gateway mit dem Mobilfunknetz und erstellen Sie ein HTTP-API Benutzerkonto
Wir gehen davon aus, dass Sie bereits Ozeki SMS Gateway installiert haben und es mit dem Mobilfunknetz verbunden haben. Um SMS von Objective C an ein Mobiltelefon senden zu können, müssen Sie ein HTTP-API-Benutzerkonto in Ozeki SMS Gateway einrichten.
Wie Sie ein HTTP-API-Benutzerkonto einrichten (Video-Tutorial)
In diesem Video zeigen wir Ihnen, wie Sie ein neues HTTP-API-Benutzerkonto im Ozeki SMS Gateway einrichten können. Es beginnt mit der Hauptseite des Ozeki SMS Gateways und führt Sie bis zur Erstellung eines funktionierenden Benutzerkontos. Sie lernen, wie Sie ein Passwort für das Benutzerkonto vergeben und wie Sie die Protokollierung aktivieren. Dieses Video ist nur 30 Minuten lang, aber sehr detailliert. Sie werden keine Probleme haben, es zu verstehen. Im Video verwenden wir das Ozeki SMS Gateway, das über eine sehr intuitive grafische Oberfläche verfügt.
Wie Sie SMS aus Objective C mit der Objective C SMS API senden (Video-Tutorial)
Dieses Video zeigt Ihnen, wie Sie die Datei SendSms.m.zip von dieser Seite herunterladen und wie Sie deren Inhalt in Xcode herunterladen. Wenn Sie das Video ansehen, werden Sie feststellen, dass der Inhalt der SendSms.m.zip auf den Desktop gelegt wird. Sie werden auch sehen, dass wir doppelt auf die SendSms.xcodeproj-Projektdatei klicken, um das SendSms-Projekt zu öffnen. Xcode zeigt einige Warnungen an, da die Datei aus dem Internet stammt. Klicken Sie einfach auf OK, um diese Warnungen zu vermeiden.
Objective C SMS Beispiel: SendSms.xcodeproj
Der folgende Beispielcode ist Teil des SendSms.xcodeproj Xcode-Projekts. In diesem Projekt gibt es drei Dateien: SendSms.m, Ozeki.Libs.Rest.m, Ozeki.Libs.Rest.h.
Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde
Nachdem die SMS übermittelt wurde, ist es ratsam, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es empfangen hat. Sie können das Protokoll einsehen, indem Sie die Details des HTTP-Benutzers in der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.
SMS-Versand mit dem oben genannten Objective C-Code (Video-Tutorial)
In diesem Video können Sie lernen, wie Sie Ihren Code ausführen und die Ereignisse beim Benutzer überprüfen. Es beginnt mit einem leeren Ereignis-Tab und führt Sie bis zu einem Ereignis-Tab mit Einträgen. Sie können jederzeit weitere Details zu Ihrer Nachricht und Verbindung im Ereignis-Tab des Benutzers einsehen. Es zeigt Ihnen, wie Sie den Ereignis-Tab öffnen, die Nachricht senden und den Ereignis-Tab erneut überprüfen. Dieses Video ist nur etwas länger als 1 Minute und leicht verständlich. Wir verwenden das Ozeki SMS Gateway, um jeden Detail eines Sendevorgangs aufzuzeichnen.
Wie man überprüft, ob die SMS an das Mobilfunknetz gesendet wurde
Der letzte Schritt zur Überprüfung des Vorgangs besteht darin, die Protokolle der Mobilfunknetzverbindung einzusehen. Möglicherweise müssen Sie die Protokollierung in der Konfiguration der Verbindung aktivieren, bevor Sie die Nachricht senden, um die Protokolle zu sehen. Wenn die Protokollierung aktiviert ist, sehen Sie die Telefonnummer und den Text der gesendeten Nachricht.
Wie man testet, ob die Anfrage vom SMPP-Client akzeptiert wurde (Video-Tutorial)
In diesem Video überprüfen wir den Eintrag für das Sendeereignis im Ereignis-Tab des SMPP-Clients. Sie lernen, wie Sie darauf zugreifen und worauf Sie im Protokoll achten müssen. Das Video ist nur 18 Sekunden lang, sodass Sie keine Probleme haben werden, ihm zu folgen. Auch hier verwenden wir das Ozeki SMS Gateway.
SMS-Nachricht auf dem Mobiltelefon empfangen (Video-Tutorial)
Im letzten Video können Sie sehen, wie der Empfang einer Nachricht, die vom Ozeki SMS Gateway gesendet wurde, aussieht. Sie sehen ein IOS-Telefon, das eine Benachrichtigung über die soeben gesendete SMS erhält. Das Video ist nur 8 Sekunden lang und sehr detailliert.
Zusammenfassung
Diese Anleitung gab einen Einblick in den SMS-Versand in Objective C mit Hilfe des Ozeki SMS Gateways. Wenn der Artikel sorgfältig studiert wurde, ist das Versenden von Nachrichten in Objective C sehr einfach. Es muss betont werden, dass das Ozeki SMS Gateway eine enorme Rolle in diesem Prozess spielt, da es die Übertragung zwischen dem Programmierer und dem SMS-Empfänger übernimmt. Das Ozeki SMS Gateway ist sehr zuverlässig und lässt sich leicht verwalten.
Setzen Sie Ihre Studien auf der Tutorial-Seite von Ozeki fort, wo Sie mehr über Themen wie mehrfachen SMS-Versand und SMS-Planung in Objective C lesen können.
Das Einzige, was jetzt noch zu tun ist, ist das Ozeki SMS Gateway herunterzuladen und die Arbeit zu beginnen!
More information
- Objective-C SMS mit der HTTP-REST-API senden (Codebeispiel)
- Objective-C mehrere SMS mit der HTTP-REST-API senden (Codebeispiel)
- Objective-C SMS mit der HTTP-REST-API planen (Codebeispiel)
- Objective C SMS mit der HTTP-REST-API empfangen (Codebeispiel)
- Objective C SMS mit der HTTP-REST-API löschen (Codebeispiel)
- So laden Sie die neueste Objective-C-SMS-Bibliothek von Github herunter