Ghid de conectare la server

Serverul TCP/MCP vă permite să interogați datele de sănătate direct de pe alte dispozitive prin rețeaua locală. Astfel puteți integra Health Auto Export cu alte aplicații, scripturi sau servicii care rulează în aceeași rețea.

Prezentare generală

Serverul TCP/MCP creează un server în rețeaua locală care acceptă conexiuni de la alte dispozitive și aplicații. Puteți interoga date de sănătate, rula automatizări și interacționa programatic cu Health Auto Export.

Cazuri de utilizare:

• Interogarea datelor de sănătate de pe alte dispozitive din rețea
• Integrarea cu aplicații și scripturi locale
• Accesarea datelor de sănătate din unelte în linia de comandă
• Construirea de integrări personalizate folosind protocolul MCP

Caracteristici principale:

• Server pe TCP, pentru conexiuni fiabile
• Suport MCP (Model Context Protocol)
• Acces în rețeaua locală
• Interogări în timp real ale datelor de sănătate
• Control programatic al automatizărilor

Limitări:

• Aplicația trebuie să ruleze în prim-plan
• În prezent, traficul este necriptat (folosiți doar în rețele de încredere)
• Necesită permisiunea Rețea locală
• Conexiunile funcționează doar atât timp cât serverul rulează

Cerințe preliminare

• Health Auto Export rulează pe iPhone/iPad
• Dispozitive în aceeași rețea locală
• Permisiunea Rețea locală acordată
• Abonament Premium
• Rețea de încredere

Afișare adresă IP / port:

• Serverul afișează adresa IP a dispozitivului
• Portul implicit este 9000

Versiune server

• v0.0.1: mod de compatibilitate moștenit (recomandat pentru configurațiile existente).
• v1.0.0: comportament actualizat aliniat la cel mai recent contract al serverului MCP.

Versiunea selectată influențează valorile implicite ale instrumentelor și compatibilitatea răspunsurilor. Dacă schimbi versiunea, repornește serverul pentru ca modificarea să producă efecte.

Conectarea la server

Găsirea adresei IP

Ecranul Server afișează automat adresa IP a dispozitivului. Aceasta este adresa pe care celelalte dispozitive ar trebui să o folosească pentru conectare.

Exemplu: 192.168.1.100:9000

Utilizarea serverului

Protocol MCP

Serverul folosește Model Context Protocol (MCP) pentru comunicare.

Jurnale de conexiune

Ecranul Server afișează jurnale de conexiune care includ:

• Încercări de conectare primite
• Detalii despre cereri
• Informații despre răspunsuri
• Mesaje de eroare

Vizualizarea jurnalelor:

• Jurnalele apar automat în lista de pe ecranul Server
• Derulați pentru a vedea activitatea recentă
• Jurnalele ajută la depanarea problemelor de conexiune

Sfaturi și bune practici

1. Sincronizare automată:

   • Încărcați dispozitivul și folosiți Oglindire iPhone
     • În timpul încărcării, iOS impune mai puține restricții de performanță, astfel datele se pot sincroniza mai des
     • Cu Oglindire iPhone, dispozitivul se comportă ca deblocat. Health Auto Export poate accesa datele de sănătate pentru acțiuni automate

2. Sincronizare automată (când folosiți automatizări):

   • Încărcați dispozitivul și folosiți iPhone Mirroring
     • Când dispozitivul este la încărcare, iOS aplică mai puține restricții asupra performanței, astfel că datele se pot sincroniza mai des
     • Folosind iPhone Mirroring, dispozitivul se comportă ca și cum ar fi deblocat. Astfel, datele de sănătate sunt accesibile pentru Health Auto Export, pentru a rula acțiuni automate

Pentru diagnostic avansat, exportați jurnalele complete de evenimente ale aplicației din Setări → Avansat → Exportă jurnale de evenimente sau din Jurnale de activitate → Partajare la orice automatizare (același ZIP). Consultați Ghidul jurnalelor de evenimente ale aplicației.