🚀 TRPOLARIS TP-SCREEN

Windows → Android & Windows Gerçek Zamanlı Ekran Akışı

🖥️ Sanal Ekran  •  📱 Android Viewer  •  🌐 Yerel Ağ  •  ⚡ Gerçek Zamanlı Akış

UYGULAMA İNDİRMELERİ

📌 Proje Hakkında

TRPOLARIS TP-SCREEN, Windows üzerinde sanal bir ekran oluşturarak bu ekranın görüntüsünü yerel ağ üzerinden gerçek zamanlı şekilde Android cihazlara aktarmak için geliştirilmiş bir ekran yayınlama sistemidir.

Proje; Windows sanal ekran altyapısından Android Viewer uygulamasına, otomatik driver kurulumundan sunucu keşfine ve bağlantı yönetiminden yayın istatistiklerine kadar gerekli bileşenleri tek bir yapı altında toplar.

✨ Öne Çıkan Özellikler

🖥️ Windows Server

• 🖥️ Windows üzerinde sanal ekran oluşturma
• ⚙️ Windows Indirect Display Driver (IddCx) desteği
• 🔌 Otomatik driver kurulumu
• 🔐 Driver sertifikası kurulumu
• 📡 LAN üzerinden otomatik sunucu keşfi
• 🔑 PIN tabanlı bağlantı
• 📊 Bağlantı ve yayın istatistikleri
• 🖥️ Çözünürlük yönetimi
• 🔄 İstemci bağlantı yönetimi
• 📦 Gömülü driver runtime kaynakları

📱 Android Viewer

• 🔎 Otomatik LAN sunucu keşfi
• 🔗 Hızlı sunucu bağlantısı
• 💾 Kayıtlı sunucu profilleri
• 🔐 PIN desteği
• 🔄 Otomatik yeniden bağlanma
• 📈 Gerçek zamanlı FPS
• 🌐 Mbps bilgisi
• 📶 Ping ölçümü
• 🖥️ Çözünürlük bilgisi
• 🎬 Stream durumu
• ⛶ Tam ekran görüntüleme
• 🔄 Dikey / yatay ekran desteği
• 🖥️ Windows çözünürlük değişikliklerini algılama
• 👆 Dokunmatik bilgi paneli
• 🎞️ Animasyonlu splash screen

‹ ›

🧩 Sistem Mimarisi

TP-SCREEN, Windows tarafındaki sanal ekran ile Android Viewer arasında çalışan istemci-sunucu mimarisine sahiptir.

┌────────────────────────────────────┐
│             🪟 WINDOWS             │
│                                    │
│   Windows Indirect Display Driver  │
│                │                   │
│                ▼                   │
│        🖥️ Virtual Display           │
│                │                   │
│                ▼                   │
│       ⚙️ TRPOLARIS Server          │
│                │                   │
└────────────────┼───────────────────┘
                 │
                 │ 🌐 LAN
                 │
                 ▼
┌────────────────────────────────────┐
│             📱 ANDROID             │
│                                    │
│           TPViewer App             │
│                │                   │
│                ▼                   │
│       🎬 Real-Time Display         │
└────────────────────────────────────┘

🌐 Ağ Yapısı

TRPOLARIS yerel ağ üzerinde iki temel iletişim kanalı kullanır.

🔗 Bağlantı Akışı

📱 Android Viewer
       │
       │ UDP 50504
       ▼
🔎 Sunucu Keşfi
       │
       │ TCP 50505
       ▼
🖥️ TRPOLARIS Server
       │
       ▼
🖥️ Virtual Display

🖥️ Windows Virtual Display Driver

TRPOLARIS Display Driver, Windows üzerinde sanal ekranların oluşturulmasını ve yönetilmesini sağlayan Windows Indirect Display Driver (IddCx) tabanlı driver bileşenidir.

📦 Driver Runtime

IddSampleDriver.inf
IddSampleDriver.cat
IddSampleDriver.dll
IddSampleDriver.cer
IddSampleApp.exe

Server başlatıldığında bu runtime dosyaları sanal ekran altyapısının hazırlanması için kullanılır.

🛠️ Driver Geliştirme Ortamı

Driver çözümü:

Driver/IddSampleDriver.sln

Driver'ın Release / x64 yapılandırmasıyla derlenmesi önerilir.

⚙️ Otomatik Driver Kurulumu

TRPOLARIS Server içerisinde otomatik bir driver bootstrap sistemi bulunur. Bu sistem sayesinde son kullanıcıların driver dosyalarını ve kurulum komutlarını manuel şekilde yönetmesine gerek kalmaz.

🖥️ Server.exe
      │
      ▼
⚙️ DriverBootstrap.EnsureInstalled()
      │
      ▼
📦 Embedded Driver Files
      │
      ▼
🔍 Certificate Verification
      │
      ▼
🔐 Windows Certificate Store
      │
      ▼
➡️ pnputil /add-driver
      │
      ▼
🔄 pnputil /scan-devices
      │
      ▼
⚙️ IddSampleApp.exe
      │
      ▼
🖥️ Virtual Display

🔐 Driver Sertifikası

Repository içerisinde bulunan IddSampleDriver.cer sertifikası geliştirme ve test amacıyla kullanılmaktadır.

Trusted Root
      +
Trusted Publisher

🛠️ Sistem Gereksinimleri

🔨 Windows Kurulumu ve Build

Projeyi GitHub üzerinden indirdikten sonra Windows bileşenleri aşağıdaki adımlar kullanılarak hazırlanabilir.

⚙️ x64 Driver Build

.\Build-Driver-And-Stage.ps1 -Platform x64

🖥️ Client Restore

dotnet restore .\PolarisDisplay.Client\PolarisDisplay.Client.csproj

🖥️ Client Build

dotnet build .\PolarisDisplay.Client\PolarisDisplay.Client.csproj -c Release

📦 Client Publish

dotnet publish .\PolarisDisplay.Client\PolarisDisplay.Client.csproj `
  -c Release `
  -r win-x64 `
  --self-contained true

📦 Windows Installer

Windows kurulum paketleri Inno Setup 7.x kullanılarak hazırlanır.

🚀 Server Kurulum Akışı

📦 Installer
   │
   ├── 🖥️ Server kurulumu
   ├── 🔐 Certificate kurulumu
   ├── ⚙️ Driver hazırlığı
   └── 🚀 Server başlatılması

📱 Android Viewer

Android Viewer uygulaması projenin TPViewer/ klasöründe bulunmaktadır.

🔍 Flutter Ortamını Kontrol Et

flutter doctor

🚀 Android Kurulumu

📦 Release APK

Android için release APK oluşturmak:

flutter clean
flutter pub get
flutter build apk --release

APK çıktısı:

TPViewer/build/app/outputs/flutter-apk/

🔄 Otomatik Reconnect

Ağ bağlantısı geçici olarak kesildiğinde Viewer otomatik olarak yeniden bağlantı kurabilir.

🟢 Bağlı
  │
  ▼
🔴 Bağlantı Kesildi
  │
  ▼
⏳ Bekle
  │
  ▼
🔄 Yeniden Bağlan
  │
  ▼
🟢 Bağlı

📊 Yayın İstatistikleri

İlk görüntü karesi alındığında stream aktif duruma geçer.

⛶ Tam Ekran ve Ekran Yönü

📐 Örnek

1920 × 1080
      ↓
📺 Landscape

1080 × 1920
      ↓
📱 Portrait

📁 Proje Yapısı

TRPOLARIS/
│
├── ⚙️ Driver/
│   ├── IddSampleApp/
│   ├── IddSampleDriver/
│   └── Runtime/
│       ├── IddSampleDriver.inf
│       ├── IddSampleDriver.cat
│       ├── IddSampleDriver.dll
│       ├── IddSampleDriver.cer
│       └── IddSampleApp.exe
│
├── 🖥️ PolarisDisplay.Server/
│
├── 🖼️ PolarisDisplay.Client/
│
├── 📦 Installer/
│   ├── Server/
│   │   └── Server.iss
│   └── Viewer/
│       └── Viewer.iss
│
├── 📱 TPViewer/
│   ├── android/
│   ├── assets/
│   ├── lib/
│   ├── pubspec.yaml
│   └── pubspec.lock
│
├── 📄 PolarisDisplay.sln
├── ⚙️ Build-Driver-And-Stage.ps1
├── .gitignore
├── .gitattributes
└── README.md

🧪 Release Testleri

🔧 Geliştirme Akışı

🖥️ Windows / Driver

⚙️ Driver Build
      ↓
📦 Driver Runtime
      ↓
🖥️ Server Build
      ↓
📤 Server Publish
      ↓
📦 Installer
      ↓
🧪 Test

📱 Android

📝 Flutter Source
      ↓
🧹 flutter clean
      ↓
📦 flutter pub get
      ↓
▶️ flutter run
      ↓
📱 Device Test
      ↓
📦 flutter build apk --release
      ↓
🧪 Release Test

🧹 GitHub Repository

Gereksiz build çıktılarının ve kullanıcıya özel dosyaların repository içerisine eklenmesini önlemek için .gitignore kullanılmaktadır.

.vs/
.idea/
bin/
obj/
build/
.dart_tool/
.gradle/
local.properties
*.pdb
*.log

🔒 Güvenlik

GitHub repository'sine aşağıdaki hassas bilgilerin eklenmemesi gerekir:

• 🔑 Private Keys
• 🔐 API Keys
• 🔢 Gerçek PIN bilgileri
• 📜 Production Certificates
• 🔒 Passwords
• ⚙️ Kullanıcıya özel configuration dosyaları

🧱 Ana Bileşenler

📌 Proje Durumu

TRPOLARIS TP-SCREEN, Windows ve Android tabanlı bir virtual display çözümü olarak geliştirilmektedir.

🧑‍💻 Geliştirme Yaklaşımı

Yeni özellikler geliştirilirken mevcut çalışan mimarinin mümkün olduğunca korunması hedeflenmektedir.

📄 Lisans

TRPOLARIS uygulama kodu MIT License altında lisanslanmıştır.

Driver/ klasörü altında bulunan Windows Indirect Display Driver bileşenleri Microsoft Windows Driver Samples kaynaklarından türetilmiş kodlar içerir ve ilgili Microsoft Public License (MS-PL), telif ve attribution koşullarına tabidir.

❓ Sıkça Sorulan Sorular

🚀 TRPOLARIS TP-SCREEN

Virtual Display  •  Windows  •  Android  •  LAN