Definicje |
#define | GG_STATUS_VOICE_MASK 0x20000 |
| Flaga bitowa dostepnosci informujaca ze mozemy voipowac.
|
#define | GG_STATUS_DESCR_MAXSIZE 255 |
| Maksymalna długośc opisu.
|
Wyliczenia |
enum | {
GG_STATUS_NOT_AVAIL,
GG_STATUS_NOT_AVAIL_DESCR,
GG_STATUS_FFC,
GG_STATUS_FFC_DESCR,
GG_STATUS_AVAIL,
GG_STATUS_AVAIL_DESCR,
GG_STATUS_BUSY,
GG_STATUS_BUSY_DESCR,
GG_STATUS_DND,
GG_STATUS_DND_DESCR,
GG_STATUS_INVISIBLE,
GG_STATUS_INVISIBLE_DESCR,
GG_STATUS_BLOCKED,
GG_STATUS_GGPLUS,
GG_STATUS_NOT_SET,
GG_STATUS_IMAGE_MASK,
GG_STATUS_DESCR_MASK,
GG_STATUS_FRIENDS_MASK
} |
| Rodzaje statusów użytkownika. Więcej...
|
enum | {
GG_STATUS_FLAG_UNKNOWN,
GG_STATUS_FLAG_VIDEO,
GG_STATUS_FLAG_INHERIT,
GG_STATUS_FLAG_MOBILE,
GG_STATUS_FLAG_SPAM
} |
| Rodzaje statusów użytkownika. Więcej...
|
Funkcje |
int | gg_change_status (struct gg_session *sess, int status) |
| Zmienia status użytkownika.
|
int | gg_change_status_descr (struct gg_session *sess, int status, const char *descr) |
| Zmienia status użytkownika na status opisowy.
|
int | gg_change_status_descr_time (struct gg_session *sess, int status, const char *descr, int ts) |
| Zmienia status użytkownika na status opisowy z podanym czasem powrotu.
|
int | gg_change_status_flags (struct gg_session *sess, int flags) |
| Funkcja zmieniająca flagi statusu.
|
Opis szczegółowy
Domyślnym statusem użytkownika po połączeniu z serwerem jest GG_STATUS_AVAIL
. Domyślny status połączenia można zmienić za pomocą pól status
i status_descr
struktury gg_login_params
. Już po połączeniu z serwerem, status można zmieniać za pomocą poniższych funkcji.
Przykład zmiany stanu na zajęty z opisem, widoczny tylko dla znajomych:
Aby obserwować zmiany statusu kontaktów, należy najpierw dodać do listy konktaktów ich identyfikatory, a następnie obsługiwać zdarzenia związane ze zmianami statusu.
Jeśli pole protocol_features
struktury gg_login_params
zawiera GG_FEATURE_IMAGE_DESCR
, informacja o tym, że status zawiera opis, jest dodatkowo przekazywana za pomocą flagi GG_STATUS_DESCR_MASK
. To samo dotyczy zmiany statusów osób z listy kontaktów.
Część opcji jest dostępna w postaci flag statusu, np. otrzymywanie linków od nieznajomych czy figurowanie jako klient mobilny. Można je ustawić za pomocą pola status_flags
struktury gg_login_params
lub funkcją gg_change_status_flags()
.
- Błąd:
- Nie ma możliwości poprawnego odbierania statusów zawierających czas powrotu.
Dokumentacja definicji
Flaga bitowa dostepnosci informujaca ze mozemy voipowac.
czy ma wlaczone audio (7.7)
Maksymalna długośc opisu.
Dokumentacja typów wyliczanych
Rodzaje statusów użytkownika.
- Wartości wyliczeń:
GG_STATUS_NOT_AVAIL |
Niedostępny.
|
GG_STATUS_NOT_AVAIL_DESCR |
Niedostępny z opisem.
|
GG_STATUS_FFC |
PoGGadaj ze mną
|
GG_STATUS_FFC_DESCR |
PoGGadaj ze mną z opisem.
|
GG_STATUS_AVAIL |
Dostępny.
|
GG_STATUS_AVAIL_DESCR |
Dostępny z opisem.
|
GG_STATUS_BUSY |
Zajęty.
|
GG_STATUS_BUSY_DESCR |
Zajęty z opisem.
|
GG_STATUS_DND |
Nie przeszkadzać
|
GG_STATUS_DND_DESCR |
Nie przeszakdzać z opisem.
|
GG_STATUS_INVISIBLE |
Niewidoczny (tylko własny status)
|
GG_STATUS_INVISIBLE_DESCR |
Niewidoczny z opisem (tylko własny status)
|
GG_STATUS_BLOCKED |
Zablokowany (tylko status innych)
|
GG_STATUS_GGPLUS |
Status "Korzystam z GG Plus".
|
GG_STATUS_NOT_SET |
Status nie ustawiony (przy logowaniu się do sieci)
|
GG_STATUS_IMAGE_MASK |
Flaga bitowa oznaczająca opis graficzny (tylko jeśli wybrano GG_FEATURE_IMAGE_DESCR )
|
GG_STATUS_DESCR_MASK |
Flaga bitowa oznaczająca status z opisem (tylko jeśli wybrano GG_FEATURE_IMAGE_DESCR )
|
GG_STATUS_FRIENDS_MASK |
Flaga bitowa dostępności tylko dla znajomych.
|
Rodzaje statusów użytkownika.
Mapa bitowa.
- Wartości wyliczeń:
GG_STATUS_FLAG_UNKNOWN |
Przeznaczenie nieznane, ale występuje zawsze.
|
GG_STATUS_FLAG_VIDEO |
Klient obsługuje wideorozmowy.
|
GG_STATUS_FLAG_INHERIT |
Synchronizacja statusu do innych klientów (przy logowaniu się do sieci)
|
GG_STATUS_FLAG_MOBILE |
Klient mobilny (ikona telefonu komórkowego)
|
GG_STATUS_FLAG_SPAM |
Klient chce otrzymywać linki od nieznajomych.
|
Dokumentacja funkcji
Zmienia status użytkownika.
- Parametry:
-
sess | Struktura sesji |
status | Nowy status użytkownika |
- Zwraca:
- 0 jeśli się powiodło, -1 w przypadku błędu
Zmienia status użytkownika na status opisowy.
- Parametry:
-
sess | Struktura sesji |
status | Nowy status użytkownika |
descr | Opis statusu użytkownika (lub NULL ) |
- Zwraca:
- 0 jeśli się powiodło, -1 w przypadku błędu
Zmienia status użytkownika na status opisowy z podanym czasem powrotu.
- Parametry:
-
sess | Struktura sesji |
status | Nowy status użytkownika |
descr | Opis statusu użytkownika |
ts | Czas powrotu w postaci uniksowego znacznika czasu |
- Zwraca:
- 0 jeśli się powiodło, -1 w przypadku błędu
Funkcja zmieniająca flagi statusu.
- Parametry:
-
sess | Struktura sesji |
flags | Nowe flagi statusu |
- Zwraca:
- 0 jeśli się powiodło, -1 w przypadku błędu
- Nota:
- Aby zmiany weszły w życie, należy ponownie ustawić status za pomocą funkcji z rodziny
gg_change_status()
.