Kako poslati SMS iz Kotlina
Najjednostavniji način za slanje SMS-a iz Kotlina je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slat ćete SMS poruke slanjem HTTP Post zahtjeva SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u JSON formatu. SMS gateway će poslati ovaj SMS na telefonski broj primatelja i vratit će HTTP 200 OK odgovor na vaš zahtjev. (Slika 1)
Primjer Kotlin SMS koda ispod pokazuje kako možete poslati SMS koristeći http rest SMS API Ozeki SMS Gatewaya koristeći Kotlin Ozeki.Libs.Rest biblioteku. Ova biblioteka vam je dostupna besplatno, a možete je koristiti i mijenjati u bilo kojem od vaših projekata.
MainActivity.kt
package send.sms import android.os.Build import androidx.appcompat.app.AppCompatActivity import android.os.Bundle import android.text.method.ScrollingMovementMethod import androidx.annotation.RequiresApi import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.GlobalScope import kotlinx.coroutines.launch import Ozeki.Libs.Rest.Configuration import Ozeki.Libs.Rest.Message import Ozeki.Libs.Rest.MessageApi class MainActivity : AppCompatActivity() { @RequiresApi(Build.VERSION_CODES.O) override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val btnSendRequest:android.widget.Button = findViewById(R.id.btnSendRequest) val inputToAddress:android.widget.EditText = findViewById(R.id.inputToAddress) val inputMessage:android.widget.EditText = findViewById(R.id.inputMessage) val logBox:android.widget.TextView = findViewById(R.id.logBox) logBox.movementMethod = ScrollingMovementMethod() val configuration = Configuration( username = "http_user", password = "qwe123", apiurl = "http://10.0.2.2:9509/api" ) val api = MessageApi(configuration) btnSendRequest.setOnClickListener { if (inputToAddress.text.toString() != "" && inputMessage.text.toString() != "") { GlobalScope.launch(Dispatchers.IO) { val msg = Message() msg.ToAddress = inputToAddress.text.toString() msg.Text = inputMessage.text.toString() inputToAddress.text.clear() inputMessage.text.clear() val response = api.Send(msg) logBox.text = String.format("%s\n%s", logBox.text, response.toString()) } } } } }
<?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="send.sms.MainActivity"> <Button android:id="@+id/btnSendRequest" android:layout_width="320dp" android:layout_height="50dp" android:layout_marginBottom="24dp" android:text="Pošalji" android:backgroundTint="#FF3F3F" app:layout_constraintBottom_toBottomOf="parent" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.505" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toBottomOf="@+id/logBox" app:layout_constraintVertical_bias="0.776" /> <EditText android:id="@+id/inputMessage" android:layout_width="320dp" android:layout_height="150dp" android:layout_marginTop="32dp" android:ems="10" android:gravity="start|top" android:hint="Pozdrav svijete!" android:inputType="textMultiLine" android:textColorHint="#BFBFBF" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.494" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toBottomOf="@+id/textView" /> <TextView android:id="@+id/textView" android:layout_width="320dp" android:layout_height="wrap_content" android:layout_marginTop="20dp" android:text="Poruka:" android:textSize="20sp" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.505" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toBottomOf="@+id/inputToAddress" /> <TextView android:id="@+id/textView2" android:layout_width="320dp" android:layout_height="wrap_content" android:layout_marginTop="40dp" android:text="Na adresu:" android:textSize="20sp" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.505" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" /> <EditText android:id="@+id/inputToAddress" android:layout_width="320dp" android:layout_height="wrap_content" android:layout_marginTop="16dp" android:ems="10" android:hint="+36201111111" android:inputType="textPersonName" android:textColorHint="#BFBFBF" android:textSize="18sp" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.505" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toBottomOf="@+id/textView2" /> <TextView android:id="@+id/logBox" android:layout_width="320dp" android:layout_height="160dp" android:layout_marginTop="36dp" android:scrollbars="vertical" android:text="Dnevnik:" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintHorizontal_bias="0.505" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toBottomOf="@+id/inputMessage" /> </androidx.constraintlayout.widget.ConstraintLayout>
Kako koristiti Kotlin SMS primjer:
Možete koristiti klasu Message za kreiranje SMS-a i klasu MessageApi za slanje SMS-a SMS gatewayu. SMS gateway će proslijediti vašu poruku na mobilnu mrežu bilo putem bežične veze ili putem interneta.
Preuzmi SendSms.kt
Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzimanje: SendSms.kt.zip (148Kb)
Što se nalazi u datoteci SendSms.kt.zip?
Datoteka SendSms.kt.zip sadrži primjer projekta, koji uključuje Ozeki.Libs.Rest biblioteku. S ovom bibliotekom možete slati, brisati, označavati i primati SMS poruke stvaranjem MessageApi i korištenjem metoda Send(), Delete(), Mark() i Receive(). (Slika 2)
Kako poslati SMS iz Kotlina (Brzi koraci)
Za slanje SMS-a iz Kotlina:
- Instalirajte Ozeki SMS Gateway
- Povežite Ozeki SMS Gateway s mobilnom mrežom
- Pošaljete testni SMS iz Ozeki GUI-a
- Kreirajte HTTP SMS API korisnika
- Android Studio
- Preuzmite gore navedeni primjer projekta
- Kreirajte SMS stvaranjem novog Message objekta
- Kreirajte API za slanje vaše poruke
- Koristite metodu Send za slanje vaše poruke
- Pročitajte odgovor na konzoli
- Provjerite zapisnike u SMS gatewayu
Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika
Da biste mogli slati SMS iz Kotlina, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Kotlin kod u Android Studiju. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI-a kako biste potvrdili da vaša mobilna mrežna veza radi. Završni korak za pripremu vašeg okruženja je kreiranje HTTP SMS API korisničkog računa. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez izmjena.
Nakon postavljanja okruženja, možete pokrenuti svoj Kotlin kod.
HTTP API URL za slanje SMS-a iz Kotlina
Za slanje SMS-a iz Kotlina, vaš Kotlin će morati poslati HTTP zahtjev SMS gatewayu. API URL je prikazan u nastavku. Imajte na umu da IP adresa (127.0.0.1) treba biti zamijenjena IP adresom vašeg SMS gatewaya. Ako je Ozeki SMS Gateway instaliran na istom računalu gdje se pokreće JavaScript SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala.
http://127.0.0.1:9509/api?action=rest
HTTP autentifikacija za slanje SMS-a iz Kotlina
Za autentifikaciju Kotlin SMS klijenta, morate poslati korisničko ime i lozinku u base64 kodiranom stringu na poslužitelj u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Kotlinu možete koristiti sljedeći kod za ovu kodiranje:
var usernamePassword = "%s:%s".format(username, password) return "Basic %s".format(Base64.getEncoder().encodeToString(usernamePassword.toByteArray()))
Na primjer, ako kodirate korisničko ime 'http_user' i lozinku 'qwe123', dobit ćete sljedeći base64 kodirani string: aHR0cF91c2VyOnF3ZTEyMw==. Za slanje
HTTP zaglavlje zahtjeva za slanje SMS-a iz Kotlina
Za slanje SMS poruka, morate uključiti sljedeće retke kao zaglavlja u HTTP zahtjevu. Imajte na umu da uključujemo content type i Authorization zaglavlje.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
HTTP zahtjev za slanje SMS-a iz Kotlina
Za slanje SMS-a, vaša Kotlin aplikacija će poslati HTTP zahtjev sličan onome u nastavku. Imajte na umu da ovaj zahtjev sadrži dio HTTP zaglavlja i dio HTTP tijela. HTTP tijelo je JSON kodirani podatkovni string. Sadrži broj primatelja i tekst poruka.
POST /api?action=sendmsg HTTP/1.1 Connection: Keep-Alive Content-Length: 323 Content-Type: application/json; charset=utf-8 Accept-Encoding: gzip Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw== Host: 10.0.2.2:9509 User-Agent: okhttp/4.2.2 { "messages": [ { "message_id": "b686acf6-7420-4a3d-b444-779dcffc652b", "to_address": "+36201111111", "text": "Pozdrav svijete!", "create_date": "2021-06-17T09:48:30", "valid_until": "2021-06-24T09:48:30", "time_to_send": "-999999999-01-01T00:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": true } ] }
HTTP odgovor primljen u Kotlin SMS primjeru
Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor će sadržavati statusni kod kako bi naznačio je li zahtjev za slanje SMS-a uspješan ili ne. Također će vratiti JSON kodiranu strukturu koja vam pruža korisne detalje o slanju poruke.
HTTP/1.1 200 OK User-Agent: OZEKI 10.3.120 (www.myozeki.com) Content-Type: application/json; charset=utf8 Last-Modified: Wed, 16 Jun 2021 09:06:03 GMT Server: 10/10.3.120 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": "b686acf6-7420-4a3d-b444-779dcffc652b", "from_station": "%", "to_address": "+36201111111", "to_station": "%", "text": "Hello world!", "create_date": "2021-06-17 09:48:30", "valid_until": "2021-06-24 09:48:30", "time_to_send": "2021-06-17 09:48:30", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": false, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ], "status": "SUCCESS" } ] } }
Kako poslati SMS iz Kotlina koristeći SMS API i gornji primjer projekta (Video tutorial)
Ovaj video pokazuje kako preuzeti i koristiti projekt SendSms.kt. Nakon što otvorite primjer projekta, možete primijetiti da postoji paket nazvan Ozeki.Libs.Rest. To je paket koji sadrži MessageApi i sve što vam je potrebno za slanje SMS-a koristeći Kotlin.
Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika
Nakon što je SMS poslan, dobro je provjeriti svoj SMS gateway kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz Ozeki SMS Gateway upravljačke konzole. Na kraju gornjeg videa možete vidjeti kako provjeriti je li zahtjev primljen od strane http_user. (Slika 3)
Kako izgleda korištenje aplikacije
Na Slici 4 možete vidjeti kako aplikacija izgleda nakon što pošaljete poruku s njom. Kao što možete vidjeti, vaše prethodno poslane poruke bit će pohranjene kao dnevnik ispod 'Message' tekstualnog okvira. Možete vidjeti sve informacije o poruci poput pošiljatelja, teksta i rezultata postupka slanja.
Kako provjeriti je li SMS poslan na mobilnu mrežu
Zadnji korak u provjeri postupka je pogledati dnevnike veze s mobilnom mrežom. Možda ćete morati uključiti bilježenje u konfiguraciji veze prije slanja poruke kako biste vidjeli dnevnike. Ako je bilježenje uključeno, vidjet ćete broj telefona i tekst poruke koju ste poslali.
Kako dodati Ozeki.Libs.Rest u vlastiti projekt
Ozeki.Libs.Rest knjižnicu možete besplatno preuzeti, koristiti i mijenjati.
Preuzimanje: Ozeki.Libs.Rest.kt.zip (7.66Kb)
Ako odlučite izraditi svoju aplikaciju samostalno samo s Ozeki.Libs.Rest knjižnicom, postoji nekoliko stvari koje biste trebali promijeniti u svojoj osnovnoj aplikaciji. Da biste koristili Ozeki.Libs.Rest knjižnicu, morate je staviti u java mapu glavnog direktorija
U sljedećem videu pokazat ću vam kako preuzeti i dodati Ozeki.Libs.Rest knjižnicu u vlastiti projekt.
Ovisnosti
Važno je spomenuti da Ozeki.Libs.Rest knjižnica ima neke ovisnosti. Da biste je koristili, morate dodati te ovisnosti u Gradle skripte.
implementation "com.squareup.okhttp3:okhttp:4.2.2" implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.0' implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'
Dodavanje ovisnosti (video tutorial)
U sljedećem videu naučit ćete kako dodati prethodno spomenute ovisnosti. Počet će s kopiranjem koda i vodit će vas do uspješno dodanih ovisnosti. Video traje samo 53 sekunde, ali prikazuje sve potrebne korake za dovršetak procesa. Možete pratiti ovaj tutorial bez napora.
Pristup internetu
Kako bi vaša aplikacija mogla poslati
HTTP zahtjev, morate omogućiti aplikaciji
povezivanje na internet.
U sljedećem videu pokazat ću vam kako omogućiti pristup internetu
za vašu Kotlin aplikaciju.
<uses-permission android:name="android.permission.INTERNET" />
android:usesCleartextTraffic="true"
Kako omogućiti internetsku vezu za vašu aplikaciju (Video tutorial)
Morate dodati obje ove linije u AndroidManifest.xml datoteku. U sljedećem videu pokazat ću vam gdje trebate postaviti gornje kodove. Video će započeti s kopiranjem koda i vodit će vas do uspješno dodane internetske veze. Ovaj video je detaljan i nudi jednostavno praćenje.
Zaključak
Svrha ovog vodiča bila je pokazati vam kako poslati SMS poruke iz Kotlina pomoću HTTP SMS API-ja Ozeki SMS Gatewaya. Ovo znanje koje ste naučili omogućuje vam da ostanete u kontaktu sa svojim korisnicima koristeći običan Kotlin kod. Međunarodno slanje poruka također je moguće s Ozeki SMS Gatewayom, jer radi u bilo kojoj zemlji i može slati i primati SMS putem različitih mobilnih veza.
Svakako nastavite svoje učenje ovdje, posjetite druge stranice s tutorijalima na Ozeki web stranici za više informacija. Pogledajte više vodiča o korištenju Kotlina, počnite s Kako poslati više SMS poruka iz Kotlina.
Sada je prva stvar koju trebate učiniti preuzeti Ozeki SMS Gateway i početi ga koristiti!
More information
- Kotlin slanje SMS-a s HTTP REST API-jem (primjer koda)
- Kotlin slanje višestrukih SMS-ova s HTTP REST API-jem (primjer koda)
- Kotlin zakazivanje SMS-a s HTTP REST API-jem (primjer koda)
- Kotlin primanje SMS-a s HTTP REST API-jem (primjer koda)
- Kotlin brisanje SMS-a s HTTP REST API-jem (primjer koda)
- Github: Kotlin SMS API