SkyyDesk'i kendi uygulamanıza gömün
Uygulamanıza bir kütüphane ekleyin; uygulamanın çalıştığı makineye SkyyDesk'ten bağlanılabilsin. Ayrı bir program kurulmaz. Kim bağlanırsa bağlansın, içeri alıp almamaya uygulamanız karar verir. Sunucular, hesaplar ve lisanslar bizde kalır.
İlk kez mi ekliyorsunuz? Her adımı ekran görüntüsüyle anlatan adım adım rehberi izleyin.
Her pakette kütüphane, örnekler ve İngilizce kurulum kılavuzu (README) var; Windows ve Linux paketlerinde C başlığı da var, Android paketinde Kotlin örneği. .NET paketi nuget.org'da değil, buradan iner: bir klasöre koyup paket kaynağı olarak ekleyin.
Beş adımda
- Kütüphaneyi uygulamanızın yanına koyunWindows'ta skyydesk.dll ve yanındaki DLL'ler, Linux'ta libskyydesk.so, Android'de .aar dosyası libs klasörüne. Linux'ta gereken sistem paketleri ve Android'in iki bağımlılığı README'de yazılı.
- main'in ilk satırında skyydesk_init çağırınKütüphane kendi yardımcı işleri için uygulamanızın birkaç kopyasını başlatır; bu kopyalar skyydesk_init içinde kapanır. Ondan önce yazdığınız kod o kopyalarda da çalışır.
- Olay geri çağrısını verinGeri çağrı olmadan kütüphane başlamaz: kimsenin görmediği ve onaylamadığı bir bağlantıya izin verilmez.
- Kayıt anahtarınızı verinİsteğe bağlı. Anahtar verilen makine, anahtarın sahibinin adres defterinde kendiliğinden görünür.
- skyydesk_start çağırın ve kimliği gösterinMakinenin SkyyDesk kimliğini (ve parolaya izin verdiyseniz tek kullanımlık parolayı) bağlanacak kişiye gösterin.
Kendi dilinizde
Dört dil de aynı C işlevlerini çağırır. Tam çalışan örnekler paketin examples klasöründe.
// .NET 8 or .NET 10, package SkyyDesk using SkyyDesk; var desk = new SkyyDeskHost(Path.Combine(AppContext.BaseDirectory, "skyydesk-data")); desk.Incoming += (_, c) => { if (c.Authorized) return; // Ask your user, then: desk.Accept(c.Id); // or desk.Close(c.Id) }; desk.Enrolled += (_, r) => Console.WriteLine(r.Ok ? "in the address book" : r.Error); desk.SetEnrollKey("sdk_..."); desk.Start(allowPassword: false); Console.WriteLine($"SkyyDesk ID {desk.MyId}");
/* cc app.c -L. -lskyydesk -Wl,-rpath,'$ORIGIN' */ #include "skyydesk.h" static void on_event(int kind, const char *payload, void *user) { if (kind == SKYYDESK_EVENT_INCOMING) { /* payload is JSON: "id", "name", "peer_id", "authorized" */ } } int main(void) { char id[32]; skyydesk_init("./skyydesk-data"); /* first line of main */ skyydesk_set_event_callback(on_event, NULL); skyydesk_set_option("enroll-key", "sdk_..."); skyydesk_start(0); /* 0: every connection waits for skyydesk_accept */ skyydesk_my_id(id, sizeof id); }
// JNA 5.x, no JNI code to compile public interface SkyyDesk extends Library { SkyyDesk LIB = Native.load("skyydesk", SkyyDesk.class); interface EventCb extends Callback { void invoke(int kind, String payload, Pointer user); } int skyydesk_init(String appDir); void skyydesk_set_event_callback(EventCb cb, Pointer user); int skyydesk_set_option(String key, String value); int skyydesk_start(int allowPassword); void skyydesk_accept(int connection); int skyydesk_my_id(byte[] out, int len); } // Keep the callback in a field so it is not collected. static final SkyyDesk.EventCb ON_EVENT = (kind, payload, user) -> { /* ... */ }; SkyyDesk.LIB.skyydesk_init("skyydesk-data"); SkyyDesk.LIB.skyydesk_set_event_callback(ON_EVENT, null); SkyyDesk.LIB.skyydesk_start(0);
{ uses SkyyDesk; unit in examples/delphi } procedure OnEvent(Kind: Integer; Payload: PAnsiChar; User: Pointer); cdecl; begin { Library thread: use TThread.Queue before touching a form. } if Kind = SKYYDESK_EVENT_INCOMING then Writeln('incoming: ', UTF8ToString(Payload)); end; var Buf: array[0..63] of AnsiChar; begin skyydesk_init('skyydesk-data'); skyydesk_set_event_callback(OnEvent, nil); skyydesk_set_option('enroll-key', 'sdk_...'); skyydesk_start(0); skyydesk_my_id(Buf, SizeOf(Buf)); end.
Geri çağrı kütüphanenin kendi iş parçacığında çalışır. Bir pencereye dokunmadan önce arayüz iş parçacığına geçin.
Olaylar
| Tür | Gelen bilgi | Ne yaparsınız |
|---|---|---|
| 1: bağlantı isteği | JSON: id, name, peer_id, authorized | authorized false ise skyydesk_accept(id) ya da skyydesk_close(id) |
| 2: bağlantı kapandı | bağlantı numarası | ekranınızdaki durumu güncelleyin |
| 3: kayıt sonucu | {"ok":true} ya da {"ok":false,"error":"..."} | geçersiz ya da iptal edilmiş anahtar burada görünür |
| 4: sesli görüşme | 1'deki JSON, ayrıca incoming_voice_call ve in_voice_call | incoming_voice_call true ise kullanıcıya sorun, skyydesk_answer_voice_call(id, 1 ya da 0) çağırın; kapatmak için skyydesk_end_voice_call(id) |
Makineler adres defterinize kendiliğinden düşsün
Panelde Ayarlar → Kayıt anahtarları bölümünden bir anahtar üretin. Anahtar yalnız üretildiği an bir kez gösterilir. Uygulamanıza verdiğiniz anda o makine hesabınızın adres defterinde görünür. Anahtarı panelden iptal edince yeni makine eklenmez; eklenmiş olanlar defterde kalır.
skyydesk_set_option("enroll-key", "sdk_...");
Makinenin kendisi lisans kullanmaz; lisansı bağlanan kişi kullanır. Makine sayısında sınır yok.
Hangi platformlarda
| Platform | Bağlanılan makine olabilir mi | Not |
|---|---|---|
| Windows 10/11 | Evet | |
| Linux (X11) | Evet | Wayland'de kullanıcı her oturumda ekran paylaşımını onaylar. |
| Android 7+ | Evet | Kullanıcı paylaşım her başladığında ekran kaydına izin verir; dokunma için SkyyDesk Input'u bir kez açar. Yalnız 64-bit telefonlar. |
| iOS | Hayır | iOS bir uygulamanın ekranı yönetmesine izin vermez. |
| Web sayfası | Hayır | Tarayıcı bir sayfanın bilgisayarı yönetmesine izin vermez. Web uygulamanızdan bağlanmak için aşağıya bakın. |
Web uygulamanızdan bağlanma
Web uygulamanız bağlanılan taraf olamaz, ama bağlanan taraf olabilir: kullanıcınızı makinenin oturumuna götüren bir bağlantı koymanız yeter.
<a href="https://skyydesk.com/webclient2/?id=123456789" target="_blank" rel="noopener">Connect</a>
- Oturumu yeni sekmede açın. Oturum sayfası başka bir sitenin çerçevesinde (iframe) açılmaz; tarayıcı bunu engeller.
- Yalnız izlemek için adrese
&view=1ekleyin; fare ve klavye karşı makineye gitmez. - Bağlanan kişi SkyyDesk hesabıyla giriş yapar ve kendi lisansını kullanır. Parola ya da hesap bilgisi adrese yazılmaz.
- Kimlik adres çubuğunda kalmaz: oturum sayfası açılır açılmaz adresten siler.