Protokol GDEP

Podporované typy a verzie zariadení
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
Konfigurácia meraných bodov
Literatúra
Zmeny a úpravy
Revízie dokumentu

Podporované typy a verzie zariadení

Protokol GDEP (Game Data Exchange Protocol) je implementovaný vo verzii 2.4 (aktuálne k 05/2006). Protokol slúži na posielanie a prijímanie SMS a MMS správ, spracovanie WAP požiadaviek a hranie SMS hier.
Protokol je postavený na štandardoch TCP, HTTP (resp. HTTPS) a XML. Účastníkmi komunikácie sú GAP server (GAme Platform) na strane Orange a aplikácia (D2000 KOM proces).
Implementácia v D2000 podporuje nasledovné správy protokolu:

Tab. č. 1

Správa	Smer	Popis
HELLO	KOM->GAP	Prihlasovanie sa (meno+heslo) ku GAP platforme pri nadväzovaní spojenia.
INQUIRE_LINK	KOM->GAP GAP->KOM	Testovanie funkčnosti spojenia pri dlhšej dobe nečinnosti.
INQ_RSP	KOM->GAP GAP->KOM	Odpoveď na INQUIRE.
RECEIVE (sms)	GAP->KOM	Prijatie SMS správy od GAP servera.
RCV_RSP (sms)	KOM->GAP	Potvrdenie prijatia SMS správy D2000 KOM procesom.
SEND (sms)	KOM->GAP	Poslanie SMS správy.
SND_RSP (sms)	GAP->KOM	Potvrdenie prijatie SMS správy GAP serverom.
ACCEPTED	GAP->KOM	Potvrdenie prijatie SMS alebo MMS správy SMS/MMS centrom.
ACC_RSP	KOM->GAP	Odpoveď D2000 KOM procesu na správu ACCEPTED.
RECEIPT (sms)	GAP->KOM	Potvrdenie prijatie SMS správy koncovým užívateľom.
REC_RSP	KOM->GAP	Odpoveď D2000 KOM procesu na správu RECEIPT.
BY	KOM->GAP	Ukončenie spojenia zo strany D2000 KOM procesu.
BY_RSP	GAP->KOM	Odpoveď GAP servera na správu BY.
NAK	GAP->KOM	Odmietnutie neprípustnej správy.

Nasledovné správy protokolu NIE SÚ v aktuálnej verzii implementované:

Tab. č. 2

Správa	Smer	Popis
RECEIVE (wap)	GAP->KOM	Prijatie WAP požiadavky od GAP servera.
RCV_RSP (wap)	KOM->GAP	Potvrdenie prijatia WAP požiadavky D2000 KOM procesom.
RECEIVE (mms-xml)	GAP->KOM	Prijatie MMS správy od GAP servera.
RCV_RSP (mms-xml)	KOM->GAP	Potvrdenie prijatia MMS správy D2000 KOM procesom.
SEND (mms-xml)	KOM->GAP	Poslanie MMS správy.
SND_RSP (mms-xml)	GAP->KOM	Potvrdenie prijatie MMS správy GAP serverom.
RECEIPT (mms)	GAP->KOM	Potvrdenie prijatie MMS správy koncovým užívateľom.
SCORE	KOM->GAP	Zmena skóre hráča.
SCO_RSP	GAP->KOM	Odpoveď GAP servera na správu SCORE.
NICK	KOM->GAP	Správa prezývok (nickov) hráča: vytváranie, rušenie, pridávanie, mazanie a hľadanie.
NICK_RSP	GAP->KOM	Odpoveď GAP servera na správu NICK.

Konfigurácia komunikačnej linky

Kategória komunikačnej linky: TCP/IP-TCP
TCP Parametre:

Host: String max. 80 znakov – meno servera vo formáte INET (meno alebo číselná adresa a.b.c.d).
Port: Číslo TCP portu (1 až 65535).
Číslo linky: Nepoužité, zadajte ľubovoľné číslo.

Poznámka: Protokol GDEP je postavený nad HTTP alebo HTTPS protokolom. D2000 KOM proces neobsahuje HTTPS komunikáciu - táto je riešená modulárne pomocou programu stunnel. Program stunnel je schopný zabaliť do SSL vrstvy klientskú aj serverovskú časť komunikácie. Keďže GDEP protokol vyžaduje na oboch stranách (GAP server aj D2000 KOM) implementáciu klienta aj servera, je nutné spustiť dva stunnel procesy:

jeden v serverovskom móde, ktorý bude čakať na pripojenie sa GAP servera a po spracovaní SSL vrstvy dáta prepošle na dohodnutý port, na ktorom čaká D2000 KOM ako GDEP server (viď parameter Server Port),
ďalší v klientskom móde, ktorý čaká na dohodnutom porte. K nemu sa pripojí D2000 KOM (klientska časť) a po zabalení dát do SSL vrstvy ich stunnel pošle na zadefinovaný cieľový počítač a port (serverovský port GAP servera). Preto bude v parametri Host zrejme uvedený localhost a v parametri Port uvedený port, na ktorom čaká stunnel proces v klientskom móde.

Konfigurácia komunikačnej stanice

Komunikačný protokol: GDEP
Adresa stanice: nepoužitá

Poznámka: Na linke musí byť PRESNE JEDNA komunikačná stanica.

Parametre protokolu stanice

Môžu byť zadané nasledovné parametre protokolu stanice:

Tab. č. 3

Kľúčové slovo	Plný názov	Popis	Jednotka	Náhradná hodnota
RD	Relogin Delay	Čakanie pred pokusom o znovupripojenie sa ku GAP serveru	sec	10
TKI	TCP KeepInit option	KeepInit nastavenie TCP protokolu.	-	False
CE	Station Communication Error	Počet neúspešných pokusov o pripojenie sa, po ktorých stanica prechádza do stavu StCOMERR.	-	1
HE	Station Hard Error	Počet neúspešných pokusov o pripojenie sa, po ktorých stanica prechádza do stavu StHARDERR.	-	3
U	User Name	Užívateľské meno na prihlásenie sa ku GAP serveru.	-	-
P	UserPassword	Heslo na prihlásenie sa ku GAP serveru.	-	-
HH	HTTP Host	IP adresa alebo meno servera uvádzané v HTTP requeste.	-	-
HP	HTTP Port	Port servera uvádzaný v HTTP requeste.	-	0
SP	Server Port	Port, na ktorom počúva KOM ako server.	-	1000
TSI	Timeout Send Inquire	Timeout, po ktorom KOM pošle INQUIRE správu (0=vypnuté).	sec	90
TRI	Timeout Receive Inq_Rsp	Timeout, do ktorého KOM očakáva INQ_RSP (odpoveď na INQUIRE).	sec	10
TRA	Timeout Receive Accept	Timeout, po ktorom vyhlási KOM proces správu za timeoutovanú (úroveň potvrdenia 2), ak dovtedy nepríde správa ACCEPTED.	sec	10
TRR	Timeout Receive Receipt	Timeout, po ktorom vyhlási KOM proces správu za timeoutovanú (úroveň potvrdenia 3), ak dovtedy nepríde správa RECEIPT.	sec	60
K1 H1 P1 K2 H2 P2	KOM Name 1 Host Address 1 Port Number 1 KOM Name 2 Host Address 2 Port Number 2	Pri nasadení v redundantnom systéme D2000 (dva procesy D2000 KOM): ak sa meno počítača, na ktorom beží proces D2000 KOM zhoduje s parametrom K1 (resp. K2), pri pripájaní sa na GAP server bude HELLO správa obsahovať voliteľné parametre host a port s hodnotami H1 a P1 (resp. H2 a P2). Takto GAP vie, na ktorý z dvoch procesov D2000 KOM sa má pripojiť.

Konfigurácia meraných bodov

Merané body sú definované svojou adresou, ktorá musí zodpovedať adrese uvedenej v nasledujúcich tabuľkách. Názvy meraných bodov sa môžu líšiť a sú uvedené iba kvôli odvolávke na ne v ďalšom texte.

Príjem SMS správ: Po príjme SMS správy sa nastavia hodnoty nasledovných meraných bodov (pokiaľ sú body nakonfigurované).

Tab. č. 4

Adresa	Typ	Názov bodu	Popis
1	TxtO	Rcv_Id	64-bitové ID prijatej SMS správy (správa RECEIVE). Po spracovaní správy aplikáciou treba zápisom do tohto meraného bodu oznámiť KOM procesu, že môže potvrdiť prijatie správou RCV_RSP a zároveň sprístupniť aplikácii ďalšiu SMS správu (pokiaľ čaká vo fronte). [message sequence ID on the Game Platform (64-bit number displayed decimally in ASCII format). It is used for duplicate receipt detection when a session has been re-established after the connection failure.]
2	TxtI	Rcv_Serv_Id	Parameter serv_id prijatej správy. [service ID that this message belongs to.]
3	TxtI	Rcv_AppAddr	Parameter appaddr prijatej správy. [destination number. It can be short or long number dedicated to the service (External Application). It is identification of the game. It is never encrypted. ]
4	TxtI	Rcv_AppAddrType	Atribút type parametra appaddr.
5	TxtI	Rcv_Msisdn	Parameter msisdn prijatej správy. [source number. Can be encrypted, see the type attribute.]
6	TxtI	Rcv_MsisdnType	Atribút type parametra msisdn.
7	Ci	Rcv_Employee	Parameter employee prijatej správy. [if application have enabled mark of employee, then element employee has value 0 – if source MSISDN is NOT employee 1 – if source MSISDN is employee]
8	Ci	Rcv_Dcs	Parameter dcs prijatej správy. [parameter data_coding of the GDEP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
9	Ci	Rcv_Esm	Parameter esm prijatej správy. [parameter esm of the SMPP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
10	TxtI	Rcv_Recv_Date	Parameter receive_date prijatej správy. [time of receive SMS to SMS center.]
11	TxtI	Rcv_Coding	Atribút coding parametra content. [type of coding in the element content. Currently used are: text ASCII text, base64 content is coded by code base64 – this is used for binary data.]
12	TxtI	Rcv_Content	Parameter content prijatej správy. [nothing but data. Data sent by the subscriber to the External Application (SMS).]
13	TxtI	Rcv_MsgPart	Parameter msg_part prijatej správy (trojica ref_num/seg_num/tot_seg). [ref_num - contain a originator generated reference number so that a segmented short message may be reassembled into a single original message seg_num - sequence number of particular message within the concatenated message tot_seg - indicating the total number of fragments]

Posielanie SMS správ: Pri posielaní SMS správy je potrebné nastaviť hodnoty nasledovných meraných bodov (pokiaľ sú body nakonfigurované). Správa sa pošle až po nastavení hodnoty meraného bodu Snd_AppDefId.
Značka (o) uvedená pri meranom bode znamená, že bod je voliteľný (nemusí byť nakonfigurovaný, pretože GDEP protokol tento atribút uvádza ako nepovinný).

Tab. č. 5

Adresa	Typ	Názov bodu	Popis
101	TxtO	Snd_Serv_Id	Parameter serv_id odosielanej správy. [service ID that this message belongs to.]
102	TxtO	Snd_Rcv_Msg_Id (o)	Parameter rcv_msg_id odosielanej správy. [ID of received message (RECEIVE) that this message is a response to]
103	TxtO