Kako primiti SMS u Kotlinu

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, slati ć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 vratiti HTTP 200 OK odgovor na vaš zahtjev. (Slika 1)

kako primiti sms u kotlinu
Slika 1 - Kako primiti SMS u Kotlinu

Kotlin kod za primanje SMS-a na mobitel

Kotlin SMS primjer koda ispod pokazuje kako možete primiti SMS poruku(e) koristeći http rest SMS API Ozeki SMS Gatewaya s Kotlin Ozeki.Libs.Rest bibliotekom. Ova biblioteka vam je dostupna besplatno i možete je koristiti i mijenjati u bilo kojem od vaših projekata.

Video 1 - Kako preuzeti ReceiveSms.kt.zip primjer (Video tutorial)

MainActivity.kt 
package receive.sms

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import Ozeki.Libs.Rest.*
import android.widget.ArrayAdapter
import kotlinx.coroutines.*

class MainActivity : AppCompatActivity() {
    @DelicateCoroutinesApi
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val listMessages:android.widget.ListView = findViewById(R.id.listMessages)
        val btnSendRequest:android.widget.Button = findViewById(R.id.btnSendRequest)

        val configuration = Configuration(
            username = "http_user",
            password = "qwe123",
            apiurl = "http://10.0.2.2:9509/api"
        )

        val messages_label : ArrayList<Message> = arrayListOf()

        val arrayAdapter = ArrayAdapter<Message>(this, android.R.layout.simple_list_item_1, messages_label)

        listMessages.adapter = arrayAdapter

        val api = MessageApi(configuration)

        btnSendRequest.setOnClickListener {
            GlobalScope.launch(Dispatchers.IO) {
                val result = api.DownloadIncomming()
                val messages = result.Messages
                for (index in 0 until messages.size) {
                    messages_label.add(messages.get(index))
                }
            }
            arrayAdapter.notifyDataSetChanged()
        }
    }
}
main_activity.xml 
<?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=".MainActivity">

    <Button
        android:id="@+id/btnSendRequest"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:backgroundTint="#FF3F3F"
        android:text="Preuzmi dolazne"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/listMessages" />

    <TextView
        android:id="@+id/textMessages"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:text="Poruke"
        android:textAlignment="center"
        android:textSize="22sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <ListView
        android:id="@+id/listMessages"
        android:layout_width="320dp"
        android:layout_height="500dp"
        android:layout_marginTop="24dp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textMessages" />
</androidx.constraintlayout.widget.ConstraintLayout>

Kako koristiti Kotlin SMS primjer:

Možete koristiti klasu MessageApi za primanje SMS poruka(e) iz SMS gatewaya. Vaš zahtjev s vašeg uređaja bit će proslijeđen SMS gatewayu putem interneta.

Preuzmi ReceiveSms.kt

Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzmi: ReceiveSms.kt.zip (148Kb)

Što je u ReceiveSms.kt.zip datoteci?

ReceiveSms.kt.zip datoteka sadrži primjer projekta, koji ima Ozeki.Libs.Rest biblioteku u sebi. S ovom bibliotekom možete slati, brisati, označavati i primati SMS poruke stvaranjem MessageApi i korištenjem Send(), Delete(), Mark() i Receive() metoda. (Slika 2)

primjer projekta za primanje sms-a koristeći kotlin
Slika 2 - ReceiveSms.kt direktorij

Kako primiti SMS s Kotlinom (Brzi koraci)

Za primanje SMS-a s Kotlinom:

  1. Instalirajte Ozeki SMS Gateway
  2. Povežite Ozeki SMS Gateway s mobilnom mrežom
  3. Pošaljite testni SMS iz Ozeki GUI-a
  4. Kreirajte HTTP SMS API korisnika
  5. Android Studio
  6. Preuzmite gore navedeni primjer projekta
  7. Kreirajte API za preuzimanje dolaznih poruka
  8. Koristite DownloadIncoming() metodu za primanje vaših poruka
  9. Pročitajte odgovor poruke na konzoli
  10. Provjerite logove u SMS gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli primati SMS poruke s Kotlinom, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu na kojem razvijate svoj Kotlin kod u Android Studiju. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testnu SMS poruku iz Ozeki sučelja kako biste potvrdili da vaša mobilna mrežna veza radi. Posljednji 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 što je okruženje postavljeno, možete pokrenuti svoj Kotlin kod.

HTTP API URL za slanje SMS-a iz Kotlina

Da biste primali SMS poruke s Kotlinom, 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 na kojem 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 primanje SMS-a s Kotlinom

Da biste autentificirali Kotlin SMS klijent, 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

Da biste primili SMS poruku(e), 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 primanje SMS-a s Kotlinom

Da biste primili dolazne SMS poruke, 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 poruke. 

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Connection: Keep-Alive
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 10.0.2.2:9509
User-Agent: okhttp/4.2.2

HTTP odgovor primljen od Kotlin SMS primjera

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 bio 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: Thu, 17 Jun 2021 16:10:48 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "ada7ee44-aefc-e746-9376-b76e3674442a",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36203333333",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-06-17 16:09:11",
	      "valid_until": "2021-06-24 16:09:11",
	      "time_to_send": "2021-06-17 16:09:11",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "fccc6211-c710-c80e-a28f-664ff8b0e964",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36201111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-06-17 16:09:11",
	      "valid_until": "2021-06-24 16:09:11",
	      "time_to_send": "2021-06-17 16:09:11",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "ba782a64-05cd-8ba8-9f4c-e8597ca30b59",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36202222222",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-06-17 16:09:11",
	      "valid_until": "2021-06-24 16:09:11",
	      "time_to_send": "2021-06-17 16:09:11",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}
Kako primati SMS poruke s Kotlinom koristeći SMS API i gornji primjer projekta (Video tutorial)

Ovaj video pokazuje kako preuzeti i koristiti projekt ReceiveSms.kt. Nakon što otvorite primjer projekta, možete primijetiti da postoji paket pod nazivom Ozeki.Libs.Rest. To je paket koji sadrži MessageApi i sve što vam je potrebno za primanje SMS poruka koristeći Kotlin.

Video 2 - Kako primati SMS poruke s gornjim Kotlin kodom (Video tutorial)

Kako provjeriti je li zahtjev prihvaćen od strane HTTP korisnika

Nakon što je SMS poslan, dobro je provjeriti vaš SMS pristupnik, kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz upravljačke konzole Ozeki SMS pristupnika. Na kraju gornjeg videa možete vidjeti kako provjeriti je li zahtjev primljen od strane http_user. (Slika 3)

kotlin projekt za primanje sms poruka
Slika 3 - ReceiveSms.kt projekt u Android Studiju

Kako izgleda korištenje aplikacije na telefonu (video tutorial)

Na Slici 4 možete vidjeti kako izgleda korištenje aplikacije na telefonu. Kao što možete vidjeti na slici Prije, po defaultu nemate dolazne poruke. Pritisnite 'Preuzmi dolazne' kako biste dobili poruke poslane za vas. Na slici Nakon možete vidjeti da su sve informacije o poruci vidljive nakon što je preuzmete.

primjer kotlin aplikacije za primanje sms poruka

Slika 4 - Primjer aplikacije ReceiveSms prije i nakon preuzimanja poruka

Kako dodati Ozeki.Libs.Rest u vlastiti projekt

Ozeki.Libs.Rest knjižnicu možete besplatno preuzeti, koristiti i mijenjati.
Preuzmi: 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 trebate promijeniti u osnovnoj aplikaciji. Kako 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.

Video 3 - Kako dodati Ozeki.Libs.Rest knjižnicu u vlastitu aplikaciju (Video tutorial)

Ovisnosti

Važno je napomenuti da Ozeki.Libs.Rest knjižnica ima neke ovisnosti. Kako 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'

Kod 1 - Popis ovisnosti koje trebate uključiti.

Dodajte ovisnosti (Video tutorial)

U sljedećem videu vidjet ćete kako priložiti prethodno spomenute ovisnosti. Počet će s kopiranjem koda i odvest će vas do uspješno dodanih ovisnosti. Video traje samo 53 sekunde, ali sadrži sve potrebne korake za dovršetak metode. Možete pratiti ovaj tutorial bez napora.

Video 4 - Kako dodati potrebne ovisnosti (Video tutorial)

Pristup internetu

Kako biste omogućili svojoj aplikaciji slanje HTTP zahtjeva, morate omogućiti svojoj 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" />

Kod 2 - Omogućavanje pristupa internetu za vašu Kotlin aplikaciju.

android:usesCleartextTraffic="true"

Kod 3 - Omogućavanje slanja http zahtjeva

Kako dodati internetsku vezu u svoj projekt (Video tutorial)

Morate dodati obje ove linije u datoteku AndroidManifest.xml.
U sljedećem videu pokazat ću vam gdje trebate umetnuti gornje kodove. Video će početi s kopiranjem koda i odvest će vas do uspješno dodane internetske veze. Ovaj video je precizan i lako ga je pratiti.

Video 5 - Kako omogućiti pristup internetu za svoju aplikaciju (Video tutorial)

Zaključak

Ovaj vodič je napisan kako bi pokazao korake primanja SMS-a u Kotlinu koristeći HTTP korisnika Ozeki SMS pristupnika. Ovo rješenje vam pomaže prikupljati poruke koje primate u mapu Dolazne poruke i premještati ih u svoj Kotlin program. Korištenjem ovog rješenja dobivate mogućnost održavanja organiziranog sustava poruka prema vašem planu.

Ovo je samo početak, saznajte više o upravljanju svojim porukama na web stranici Ozeki. Kako biste ostali učinkoviti i ažurirani, razvrstajte poruke, pročitajte sljedeći članak o Kako izbrisati SMS u Kotlinu.

Krenimo na posao, postavite Ozeki SMS pristupnik sada!

More information