Πλατφόρμα προγραμματιστών

Βασιστείτε στο
Πλατφόρμα σύνδεσης

Δύο ισχυρά API — ένα RESTful API διακομιστή για διαχείριση συσκευών και ενορχήστρωση επικοινωνίας και ένα πρωτόκολλο CBBP χαμηλού επιπέδου για άμεσο έλεγχο σημάτων.

Αναφορά REST APIΠρωτόκολλο CBBP
OpenAPI 3.0JSON / RESTBluetooth + WiFiΥποστήριξη Webhook
Connection Studio
Explorer
examples
send_command.http
response.json
list_devices.http
webhooks.http
src
docs
send_command.http
response.json
# Send a CBBP command via the server
POST /api/v1/devices/{uuid}/cbbp

{
  "command": "speak",
  "object": {
    "text": "Shift starts in 5 minutes",
    "volume": 85,
    "language": "en-US"
  }
}

# Response
{
  "result": 0,
  "detail": "ok"
}
main
HTTPUTF-8Ln 2, Col 1

API REST

Πλήρης διαχείριση κύκλου ζωής συσκευής — παροχή, διαμόρφωση, υλικολογισμικό, επικοινωνίες και αναλυτικά στοιχεία — μέσω τυπικού HTTPS.

Εξερευνήστε το REST API →

Πρωτόκολλο CBBP

Βασικό πρωτόκολλο Com Badge — ένα πρωτόκολλο εντολών JSON για άμεσο έλεγχο συσκευής μέσω Bluetooth (εφαρμογή), WiFi (διακομιστής μεσολάβησης) ή τοπικής αποστολής.

Εξερευνήστε το CBBP →

Ιστοσελίδες

Εγγραφείτε σε συμβάντα συσκευών σε πραγματικό χρόνο — επικοινωνίες, αλλαγές κατάστασης, ενημερώσεις τοποθεσίας — που παραδίδονται ως φορτία HTTP POST στο τελικό σας σημείο.

Εξερευνήστε τα Webhooks →

Early Access: The Connection API is currently available by special request to select partners. Contact us to apply for access.

Pro or Plus plan required: Badges must be on the Pro or Plus plan to be controlled via the API.

Ξεκινώντας

Πιστοποίηση

Το API σύνδεσης χρησιμοποιεί έλεγχο ταυτότητας διακριτικού φορέα. Όλα τα αιτήματα πρέπει να περιλαμβάνουν ένα έγκυρο διακριτικό πρόσβασης JWT στην κεφαλίδα Εξουσιοδότησης.

Αποκτήστε ένα διακριτικό

ΑΠΟΣΤΟΛΗΣΤΕ τα διαπιστευτήριά σας στο τελικό σημείο ελέγχου ταυτότητας. Θα λάβετε ένα βραχύβιο access_token και ένα refresh_token μεγαλύτερης διάρκειας.

Χρησιμοποιήστε το διακριτικό

Συμπεριλάβετε το διακριτικό σε κάθε αίτημα:

Authorization: Bearer <access_token>
POST/api/v1/auth/login
Αίτηση
{
  "email": "admin@yourorg.com",
  "password": "••••••••"
}
Απάντηση 200
{
  "access_token": "eyJhbG...",
  "refresh_token": "dGhpcw...",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Βασική διεύθυνση URL και διαχείριση εκδόσεων

Όλα τα τελικά σημεία API έχουν έκδοση /api/v1/. Η βασική διεύθυνση URL εξαρτάται από την ανάπτυξή σας.

Για αναπτύξεις που φιλοξενούνται στο cloud, χρησιμοποιήστε το περιφερειακό τελικό σημείο που έχει αντιστοιχιστεί στον οργανισμό σας. Για αναπτύξεις διακομιστών εσωτερικής εγκατάστασης, χρησιμοποιήστε το όνομα κεντρικού υπολογιστή του διακομιστή σας.

ΠεριβάλλοΒασική διεύθυνση URL
Cloud (ΗΠΑ)https://beta.connection.app/api/v1
Εσωτερική χρήσηhttps://<your-server>/api/v1
Τύπος περιεχομένου
Όλα τα σώματα αιτημάτων και απαντήσεων χρησιμοποιούν application/json. Συμπεριλάβετε τον τύπο περιεχομένου: application/json σε αιτήματα με σώμα.

Σφάλματα και Κωδικοί Κατάστασης

Το API χρησιμοποιεί τυπικούς κωδικούς κατάστασης HTTP. Οι απαντήσεις σφάλματος περιλαμβάνουν έναν κώδικα αναγνώσιμο από μηχανή και ένα μήνυμα αναγνώσιμο από άνθρωπο.

ΚατάστασηΕννοια
200Επιτυχία
201Δημιουργήθηκε
400Λανθασμένο αίτημα — μη έγκυρες παράμετροι
401Μη εξουσιοδοτημένο — διακριτικό που λείπει ή έχει λήξει
403Απαγορεύεται — ανεπαρκή δικαιώματα
404Δεν βρέθηκε
500Εσωτερικό σφάλμα διακομιστή
Απόκριση σφάλματος
{
  "error": {
    "code": "device_not_found",
    "message": "No device with that UUID exists in your organization",
    "status": 404
  }
}
API REST

Επισκόπηση REST API

Το Connection Server REST API παρέχει πλήρη προγραμματική πρόσβαση στο στόλο συσκευών σας, στην υποδομή επικοινωνιών και στα αναλυτικά στοιχεία. Ακολουθεί τις συμβάσεις RESTful με σώματα αιτημάτων/απαντήσεων JSON.

Έλεγχος ταυτότητας API
Χρήστες
Συσκευές
Κανάλια
Ανακοίνωση
Γέφυρα ήχου
Συζητήσεις
Περιεχόμενο
Τοποθεσίες
Ειδοποιήσεις push
Αποθήκευση
Μαζικές Λειτουργίες
Ημερομηνία & Ώρα

Πιστοποίηση

Έλεγχος ταυτότητας βάσει διακριτικού. Η σύνδεση επιστρέφει ένα διακριτικό που πρέπει να σταλεί ως Εξουσιοδότηση: Διακριτικό<token> σε όλα τα επόμενα αιτήματα.

POST/api/v1/loginΕπαλήθευση ταυτότητας χρήστη και λήψη διακριτικού ελέγχου ταυτότητας
POST/api/v1/login-deviceΕπαλήθευση ταυτότητας συσκευής μέσω UUID και διεύθυνσης MAC
POST/api/v1/logoutΑκύρωση του τρέχοντος διακριτικού συνεδρίας

Χρήστες

Δημιουργήστε και διαχειριστείτε λογαριασμούς χρηστών. Το τελικό σημείο GET /users/user επιστρέφει τον τρέχοντα πιστοποιημένο χρήστη.

GET/api/v1/users/userΑνάκτηση του προφίλ χρήστη που είναι συνδεδεμένος αυτήν τη στιγμή
POST/api/v1/users/userΔημιουργήστε έναν νέο λογαριασμό χρήστη
PATCH/api/v1/users/user/{uuid}Ενημέρωση προφίλ χρήστη (π.χ. εικόνα προφίλ)

Συσκευές

Καταγράψτε και ελέγξτε συσκευές, διαχειριστείτε συσχετίσεις χρήστη-συσκευής, διαβάστε και γράψτε ρυθμίσεις και κατάσταση ανά συσκευή, χειριστείτε εικόνες υλικολογισμικού και χώρου αποθήκευσης και λάβετε αρχεία καταγραφής και αναφορές σφαλμάτων.

GET/api/v1/devices/deviceΛίστα όλων των συσκευών
GET/api/v1/devices/device/{uuid}Λάβετε λεπτομερείς πληροφορίες για τη συσκευή, συμπεριλαμβανομένου του υλικολογισμικού και των ρυθμίσεων
PUT/api/v1/devices/association/{uuid}Ενημέρωση της συσχέτισης μεταξύ ενός χρήστη και μιας συσκευής
DELETE/api/v1/devices/association/{uuid}Κατάργηση της συσχέτισης χρήστη-συσκευής και των αποθηκευμένων ρυθμίσεων
GET/api/v1/devices/device/{device_uuid}/settingsΛίστα ρυθμίσεων που είναι αποθηκευμένες για μια συσκευή
POST/api/v1/devices/device/{device_uuid}/settingsΑποθήκευση ρυθμίσεων που αφορούν συγκεκριμένες συσκευές
GET/api/v1/devices/device/{device_uuid}/statusΛήψη κατάστασης συσκευής (συνδεσιμότητα, μπαταρία, αισθητήρες, κατάσταση ήχου)
POST/api/v1/devices/device/{device_uuid}/statusΔημοσίευση κατάστασης συσκευής από τη συσκευή
GET/api/v1/devices/device/{device_uuid}/contextΛίστα τιμών περιβάλλοντος που είναι αποθηκευμένες για μια συσκευή
POST/api/v1/devices/device/{device_uuid}/ingest-contextΛήψη περιεχομένου GPS + WiFi από τη συσκευή
GET/api/v1/devices/firmwareΛίστα εκδόσεων υλικολογισμικού συμβατών με μια δεδομένη έκδοση υλικού/λογισμικού
GET/api/v1/devices/firmware/{uuid}/{image_type}/fetchΛήψη εικόνας υλικολογισμικού σε τμήματα
GET/api/v1/devices/languageΛίστα υποστηριζόμενων γλωσσών και φωνών συσκευών
GET/api/v1/devices/storage_imageΛήψη προσαρμοσμένης εικόνας αποθήκευσης συσκευής για μια τοπική ρύθμιση
POST/api/v1/devices/logΛήψη αρχείου καταγραφής από μια συσκευή
POST/api/v1/devices/crashΛήψη ενός core dump από μια συσκευή
PATCH/api/v1/devices/crash/{uuid}Ενημέρωση καταγραφής σφαλμάτων

Πληρεξούσιος CBBP

Στείλτε οποιαδήποτε εντολή CBBP σε μια συσκευή μέσω του διακομιστή. Ο διακομιστής μεταδίδει την εντολή μέσω της σύνδεσης WiFi της συσκευής και επιστρέφει την απόκριση της συσκευής. Η εξερχόμενη απόκριση make ενσωματώνει επίσης ένα μήνυμα CBBPMessage που εκτελεί αμέσως η συσκευή.

POST/api/v1/devices/device/{device_uuid}/cbbpΑποστολή εντολής CBBP σε μια συσκευή μέσω του διακομιστή
GET/api/v1/devices/device/{device_uuid}/cbbp/{uuid}Ανάκτηση της κατάστασης και της απόκρισης μιας εντολής CBBP που είχε σταλεί προηγουμένως

Το σώμα του αιτήματος είναι ένας φάκελος εντολής CBBP. Το αποθηκευμένο αντικείμενο CBBPCommand παρακολουθεί την κατάσταση παράδοσης: UNSET → SENT → RECEIVED ή TIMED_OUT.

Εκτελέστε polling GET /cbbp/ για να ελέγξετε εάν η συσκευή έλαβε και απάντησε στην εντολή.
Αίτημα — εξερχόμενο μήνυμα
{
  "outgoingMessage": {
    "command": "WiFiScan"
  }
}
Απόκριση — Κατάσταση εντολής CBBP
{
  "uuid": "a3f2...",
  "status": "SENT",
  "device": "d7f3a1b2-...",
  "dateSent": "2025-09-15T14:22:01Z",
  "outgoingMessage": { /* echoed */ },
  "incomingMessage": null
}

Κανάλια

Τα κανάλια είναι τα βασικά πρωτόγονα στοιχεία επικοινωνίας. Οι τύποι περιλαμβάνουν τα ChannelPeople, ChannelGroup, ChannelContact, ChannelContactNumber, ChannelExternalNumber, ChannelService και ChannelRecorder.

GET/api/v1/channels/channelΛίστα καναλιών, προαιρετικά φιλτραρισμένα κατά object_type
POST/api/v1/channels/channelΔημιουργία καναλιού (ChannelGroup, ChannelContact ή ChannelExternalNumber)
PATCH/api/v1/channels/channel/{uuid}Ενημέρωση ομάδας καναλιών ή επαφής καναλιών
DELETE/api/v1/channels/channel/{uuid}Διαγραφή καναλιού
DELETE/api/v1/channels/{uuid}Διαγραφή ομάδας καναλιών
DELETE/api/v1/channels/by-type/{channelType}Διαγραφή όλων των καναλιών ενός δεδομένου τύπου (προς το παρόν ChannelContact)
GET/api/v1/channels/associationΛίστα συσχετίσεων καναλιών για τον τρέχοντα χρήστη
POST/api/v1/channels/associationΑίτημα συσχέτισης με ένα κανάλι
PATCH/api/v1/channels/association/{uuid}Αποδοχή, απόρριψη ή ενημέρωση ρυθμίσεων συσχέτισης
DELETE/api/v1/channels/association/{uuid}Κατάργηση συσχέτισης με ένα κανάλι
GET/api/v1/channels/historyΛήψη ιστορικού πρόσβασης καναλιού σε σελίδες για τον τρέχοντα χρήστη
POST/api/v1/channels/historyΔημιουργήστε μια καταχώρηση ιστορικού καναλιού
GET/api/v1/channels/searchΑναζήτηση καναλιών με βάση τη συμβολοσειρά ερωτήματος και το προαιρετικό φίλτρο τύπου

Ανακοίνωση

Έναρξη και διαχείριση ενεργών συνεδριών επικοινωνίας — εξερχόμενες κλήσεις, VCP, εγγραφή και ροή περιεχομένου. Η απόκριση εξερχόμενης κλήσης περιλαμβάνει ένα μήνυμα CBBP στο οποίο η συσκευή ενεργεί αμέσως.

POST/api/v1/communicate/outgoing-makeΈναρξη ενός εξερχόμενου καναλιού σε ένα ChannelPeople, ChannelGroup, ChannelContact ή ChannelContactNumber
POST/api/v1/communicate/incoming-acceptanceΑποδοχή ή απόρριψη εισερχόμενου αιτήματος συμμετοχής σε κανάλι
POST/api/v1/communicate/closeΚλείσιμο του τρέχοντος ενεργού καναλιού επικοινωνίας σε μια συσκευή
POST/api/v1/communicate/vcp-activateΈναρξη πρωτοκόλλου φωνητικής επικοινωνίας (VCP) στον διακομιστή και τη συσκευή
POST/api/v1/communicate/vcp-deactivateΑπενεργοποίηση VCP, επιστροφή σε οποιοδήποτε προηγούμενο κανάλι
POST/api/v1/communicate/recording-activateΕνεργοποίηση λειτουργίας εγγραφής στον διακομιστή και τη συσκευή
POST/api/v1/communicate/content-startΆνοιγμα καναλιού ροής για περιεχόμενο ήχου
POST/api/v1/communicate/request-vocalizationΔημιουργήστε ήχο TTS για το δεδομένο κείμενο, προαιρετικά μεταφράζοντάς το

Γέφυρα ήχου

Αποκτήστε πρόσβαση σε ηχογραφημένες συνομιλίες γέφυρας, συμπεριλαμβανομένων πλήρων μεταγραφών, λιστών συμμετεχόντων και περιλήψεων που δημιουργούνται από τεχνητή νοημοσύνη. Υποστηρίζει πολλαπλά πρότυπα περιλήψεων (σημειώσεις συσκέψεων, σημειώσεις μαθήματος, υγειονομική περίθαλψη κ.λπ.) και δημιουργία ήχου TTS για περιλήψεις.

GET/api/v1/bridge/conversationsΛίστα όλων των συνομιλιών γέφυρας
GET/api/v1/bridge/conversations/{uuid}Λάβετε μια λεπτομερή συνομιλία, συμπεριλαμβανομένης της απομαγνητοφώνησης, των συμμετεχόντων και της περίληψης
POST/api/v1/bridge/conversations/{conversation_uuid}/summaryΔημιουργήστε μια σύνοψη AI για μια συνομιλία
POST/api/v1/bridge/conversations/{conversation_uuid}/summary/{summary_uuid}/audioΔημιουργία ήχου για μια σύνοψη συνομιλίας

Συζητήσεις

Συνεδρίες συνομιλίας με τεχνητή νοημοσύνη χρησιμοποιώντας ChatGPT, Gemini ή την εγγενή μηχανή αναζήτησης. Υποστηρίζει πολλαπλές περσόνες (Γιατρός, Καθηγητής, Μηχανικός κ.λπ.) και σελιδοποιημένο ιστορικό μηνυμάτων.

GET/api/v1/conversations/conversationΛίστα συνεδριών γεννήτριας τεχνητής νοημοσύνης, φιλτραριζόμενες ανά προσωπικότητα και εργαλείο
POST/api/v1/conversations/conversationΔημιουργήστε μια νέα συνεδρία συνομιλίας με τεχνητή νοημοσύνη
GET/api/v1/conversations/conversation/{uuid}Ανάκτηση μιας συνεδρίας συνομιλίας με προαιρετική ενημέρωση σύνοψης/αποχώρησης
DELETE/api/v1/conversations/conversation/{uuid}Διαγραφή μιας συνεδρίας συνομιλίας
GET/api/v1/conversations/conversation/{uuid}/messagesΛίστα μηνυμάτων σε μια συνομιλία
POST/api/v1/conversations/conversation/{uuid}/messagesΠροσθέστε ένα μήνυμα χρήστη και λάβετε μια απάντηση από την Τεχνητή Νοημοσύνη

Περιεχόμενο

Περιηγηθείτε και αναπαράγετε περιεχόμενο ήχου σε ροή σε συσκευές. Το περιεχόμενο είναι οργανωμένο σε δέντρο κατηγοριών. Το δημοφιλές περιεχόμενο μπορεί να φιλτραριστεί ανά πόλη, περιοχή ή χώρα.

GET/api/v1/content/categoriesΑποκτήστε ένα δέντρο κατηγοριών περιεχομένου
GET/api/v1/content/contentΛίστα με το διαθέσιμο περιεχόμενο σε μια κατηγορία
GET/api/v1/content/popularΚαταγράψτε δημοφιλές περιεχόμενο για μια δεδομένη πόλη, περιοχή ή χώρα

Τοποθεσίες

Ανάλυση γεωγραφικών συντεταγμένων σε ένα δομημένο αντικείμενο πόλης, περιοχής και χώρας. Χρησιμοποιείται από συσκευές κατά την εισαγωγή περιεχομένου.

POST/api/v1/location/determineΑνάλυση γεωγραφικού πλάτους/μήκους σε πόλη, περιοχή και χώρα

Ειδοποιήσεις push

Εγγραφείτε μια εφαρμογή για κινητά για να λαμβάνετε ειδοποιήσεις push FCM. Υποστηρίζει στόχους iOS, Android και web.

POST/api/v1/push-notifications/pushΕγγραφή εφαρμογής για κινητά για ειδοποιήσεις push FCM (iOS, Android, web)

Αποθήκευση

Λήψη αρχείων που είναι αποθηκευμένα σε αντικείμενα μοντέλου και εκτέλεση αφαίρεσης φόντου εικόνας (επιστρέφει αποτέλεσμα με κωδικοποίηση base64).

GET/api/v1/storage/retrieve/{path}Λήψη αποθηκευμένου αρχείου μέσω διαδρομής
POST/api/v1/storage/remove-backgroundΑφαίρεση του φόντου από μια εικόνα (επιστρέφει base64)

Μαζικές Λειτουργίες

Εκτέλεση πολλαπλών λειτουργιών API σε ένα μόνο αίτημα HTTP. Μεταβιβάστε την εντολή single_transaction=true για να τυλίξετε όλες τις λειτουργίες σε μία ατομική συναλλαγή — μια αποτυχία σε οποιοδήποτε στοιχείο αναιρεί ολόκληρη την παρτίδα.

POST/api/v1/bulkΕκτέλεση πολλαπλών λειτουργιών API σε ένα μόνο αίτημα, προαιρετικά ως μία μόνο ατομική συναλλαγή

Ημερομηνία & Ώρα

Επιστρέφει την τρέχουσα ημερομηνία και ώρα διακομιστή σε GMT+0. Δεν απαιτεί έλεγχο ταυτότητας. Χρησιμοποιείται από συσκευές για τον συγχρονισμό του εσωτερικού τους ρολογιού.

GET/api/v1/current-datetimeΕπιστροφή της τρέχουσας ημερομηνίας και ώρας σε GMT+0
Πρωτόκολλο CBBP

Βασικό Πρωτόκολλο Σήματος Com

Το CBBP είναι ένα ελαφρύ πρωτόκολλο εντολών JSON για άμεση αλληλεπίδραση με τα Connection badges. Σας δίνει πλήρη έλεγχο σε κάθε λειτουργία υλικού και λογισμικού της συσκευής.

Μορφή μηνύματος

Κάθε αλληλεπίδραση CBBP αποτελείται από ένα μήνυμα εντολής που αποστέλλεται στη συσκευή και ένα μήνυμα αποτελέσματος που επιστρέφεται από τη συσκευή.

Το πεδίο αντικειμένου τόσο στο αίτημα όσο και στην απόκριση μεταφέρει δεδομένα που αφορούν συγκεκριμένες εντολές και μπορεί να παραλειφθεί όταν δεν χρειάζεται.

Η πλήρης τεκμηρίωση του πρωτοκόλλου είναι διαθέσιμη στους εγγεγραμμένους συνεργάτες. Επικοινωνήστε με τον εκπρόσωπο της επιχείρησης Connection ή επικοινωνήστε με τον/την developer@connectionbadge.com για να ζητήσετε πρόσβαση στην πλήρη αναφορά εντολών CBBP, συμπεριλαμβανομένων των πλήρων σχημάτων αιτήματος/απόκρισης, των κωδικών σφαλμάτων και των οδηγών ενσωμάτωσης.
Μήνυμα εντολής
{
  "command": "command_name",
  "object": {
    // optional command parameters
  }
}
Μήνυμα Αποτελέσματος
{
  "result": 0,          // 0 = success, -1 = error
  "detail": "ok",      // human-readable status
  "object": {          // optional response data
    // command-specific fields
  }
}

Μεταφορά

Τα μηνύματα CBBP μπορούν να παραδοθούν σε ένα badge μέσω τριών διαφορετικών μεταφορών, ανάλογα με την αρχιτεκτονική ενσωμάτωσής σας.

Bluetooth (Εφαρμογή)

Στείλτε εντολές CBBP απευθείας από μια εφαρμογή για κινητά μέσω BLE. Απαιτεί η συσκευή να είναι συζευγμένη και εντός εμβέλειας.

SDK για κινητά

WiFi ή Bluetooth μέσω διακομιστή

Διακομιστής μεσολάβησης CBBP μέσω του REST API — POST /devices//cbbp. Ο διακομιστής δρομολογεί αυτόματα τη συσκευή μέσω WiFi ή Bluetooth, ανάλογα με τον τρόπο σύνδεσης του badge. Πιο συνηθισμένο για ενσωματώσεις backend.

API REST

Εσωτερική Αποστολή

Αποστολή CBBP εντός συσκευής ή μεταξύ διεργασιών. Χρησιμοποιείται από το υλικολογισμικό του badge για τη δρομολόγηση εντολών μεταξύ εσωτερικών υποσυστημάτων.

Μόνο υλικολογισμικό

Εντολές ισχύος

Έλεγχος κατάστασης ενέργειας της συσκευής — αναστολή λειτουργίας, αφύπνιση, επανεκκίνηση και επαναφορά εργοστασιακών ρυθμίσεων.

PowerRebootΕπανεκκινήστε αμέσως τη συσκευή.
PowerDeepsleepΕισέλθετε σε λειτουργία βαθέος ύπνου (χαμηλής κατανάλωσης ενέργειας).
FactoryResetΔιαγράψτε όλες τις ρυθμίσεις και επαναφέρετε τις εργοστασιακές ρυθμίσεις.

Εντολές WiFi

Διαμορφώστε ασύρματα δίκτυα, σαρώστε για σημεία πρόσβασης, ελέγξτε την κατάσταση σύνδεσης και διαχειριστείτε τα αποθηκευμένα διαπιστευτήρια.

WiFiScanΣάρωση για διαθέσιμα σημεία πρόσβασης WiFi.
WiFiAPTestΔοκιμή σύνδεσης σε ένα συγκεκριμένο σημείο πρόσβασης WiFi.
WiFiAPJoinΣυνδεθείτε σε ένα σημείο πρόσβασης WiFi με τα παρεχόμενα διαπιστευτήρια.

Εντολές Bluetooth

Ελέγξτε τη διαφήμιση BLE, τη σύζευξη και την επικοινωνία μεταξύ σημάτων.

BTScanBTΣάρωση για κλασικές συσκευές Bluetooth.
BTScanBLEΣάρωση για συσκευές BLE.
DeviceBLEServiceAvailableΕπισημάνετε την υπηρεσία BLE ως διαθέσιμη.
DeviceBLEServiceUnavailableΕπισημάνετε την υπηρεσία BLE ως μη διαθέσιμη.
DeviceBLEActiveΡυθμίστε το ραδιόφωνο BLE σε ενεργή κατάσταση.
DeviceBLEIdleΡυθμίστε το ραδιόφωνο BLE σε κατάσταση αναμονής.
DeviceBLEAdvChannelAddΠροσθέστε ένα κανάλι στο διαφημιστικό φορτίο BLE.
DeviceBTScanΞεκινήστε μια σάρωση συσκευής Bluetooth.
DeviceBTA2DStartΞεκινήστε τη ροή ήχου Bluetooth A2DP.
DeviceBTA2DEndΤερματισμός ροής ήχου Bluetooth A2DP.
DeviceBTNativeAssistStartΞεκινήστε τον εγγενή φωνητικό βοηθό Bluetooth.
DeviceBTNativeAssistEndΤερματίστε τον εγγενή φωνητικό βοηθό Bluetooth.

Εντολές ρυθμίσεων

Ανάγνωση και εγγραφή διαμόρφωσης συσκευής — εμφανιζόμενο όνομα, ζώνη ώρας, γλώσσα και σημαίες λειτουργιών.

SettingsListGetΑνάκτηση όλων των ρυθμίσεων ως λίστα κλειδιών-τιμών.
SettingsListSetΓράψτε πολλές τιμές ρυθμίσεων ταυτόχρονα.
SettingsGetΛάβετε την τιμή μιας μεμονωμένης ρύθμισης ανά πλήκτρο.
SettingsSetΟρίστε την τιμή μίας μόνο ρύθμισης.
SettingsSendΜεταφέρετε τις τρέχουσες ρυθμίσεις στον διακομιστή.
SettingsClearΚαθορίστε συγκεκριμένες τιμές ρύθμισης.
SettingsEraseΔιαγραφή όλων των αποθηκευμένων ρυθμίσεων.

Εντολές υλικολογισμικού

Ενεργοποιήστε ενημερώσεις υλικολογισμικού OTA, ελέγξτε την κατάσταση ενημέρωσης και υποβάλετε ερώτημα για την τρέχουσα έκδοση υλικολογισμικού στη συσκευή.

FirmwareCheckΕλέγξτε αν υπάρχει διαθέσιμη ενημέρωση υλικολογισμικού.
FirmwareUpdateΞεκινήστε μια ενημέρωση υλικολογισμικού OTA.
FirmwareValidateΕπικυρώστε την ακεραιότητα μιας εικόνας υλικολογισμικού που έχετε κατεβάσει.

Εντολές συσκευής

Κύκλος ζωής συσκευής, έλεγχος ταυτότητας, διαμόρφωση, καταγραφή, κατάσταση και έλεγχος υλικού.

NoOpΚαμία λειτουργία / διατήρηση σε λειτουργία.
TestΒασική δοκιμή συνδεσιμότητας.
DeviceDateTimeΛήψη ή ρύθμιση ημερομηνίας και ώρας στη συσκευή.
DeviceAuthenticateΕπαληθεύστε τη συσκευή με τον διακομιστή.
DeviceConfigureΕφαρμόστε ένα φορτίο διαμόρφωσης στη συσκευή.
DevicePostConnectionTasksΕκτελέστε εργασίες αρχικοποίησης μετά τη σύνδεση.
DeviceStorageLoadΦόρτωση δεδομένων από τον αποθηκευτικό χώρο της συσκευής.
DeviceLoadCustomAudioΦορτώστε προσαρμοσμένα αρχεία ήχου στη συσκευή.
DeviceCoredumpSendΜεταφορτώστε ένα αρχείο dump πυρήνα σφαλμάτων στον διακομιστή.
DeviceAttachΣυνδέστε τη συσκευή σε μια συνεδρία διακομιστή.
DeviceDetachΑποσυνδέστε τη συσκευή από μια συνεδρία διακομιστή.
DeviceLogSendΜεταφόρτωση αρχείων καταγραφής συσκευής στον διακομιστή.
DeviceConnectionTestΔοκιμή συνδεσιμότητας διακομιστή.
DeviceStatusSendΠροώθηση της κατάστασης της συσκευής στον διακομιστή.
DeviceStatusGetΛάβετε την τρέχουσα κατάσταση της συσκευής.
DeviceInteractionΕνεργοποίηση συμβάντος αλληλεπίδρασης συσκευής.
DeviceSetAPIHostΟρίστε τον κεντρικό υπολογιστή του διακομιστή API.
DeviceTestMicsΕκτελέστε έναν αυτοέλεγχο μικροφώνου.
HardwareI2CCommandΣτείλτε μια ακατέργαστη εντολή I2C σε μια περιφερειακή συσκευή υλικού.

Εντολές επικοινωνίας

Ξεκινήστε κλήσεις, στείλτε μηνύματα, διαχειριστείτε ενεργές συνεδρίες επικοινωνίας και ελέγξτε την εγγραφή.

CommunicateChannelJoinΣυμμετέχετε σε ένα κανάλι επικοινωνίας.
CommunicateChannelLeaveΑφήστε ένα κανάλι επικοινωνίας.
CommunicateChannelChangeΑλλάξτε σε διαφορετικό κανάλι.
CommunicateChannelCloseΚλείσιμο ενός καναλιού επικοινωνίας.
CommunicateReceiveIncomingΕιδοποίηση της συσκευής για εισερχόμενη επικοινωνία.
CommunicateRequestOutgoingΑίτημα για εξερχόμενη επικοινωνία.
CommunicateVCPActivateΕνεργοποιήστε την περίοδο λειτουργίας Πρωτοκόλλου Φωνητικής Επικοινωνίας.
CommunicateVCPDeactivateΑπενεργοποιήστε την περίοδο λειτουργίας VCP.
CommunicateRecordingActivateΞεκινήστε την καταγραφή της ενεργής επικοινωνίας.
CommunicateIncomingAcceptΑποδοχή εισερχόμενης κλήσης.
CommunicateIncomingRejectΑπόρριψη εισερχόμενης κλήσης.
CommunicateHFPCallStartΞεκινήστε μια τηλεφωνική κλήση Bluetooth HFP.
CommunicateHFPCallEndΤερματισμός τηλεφωνικής κλήσης Bluetooth HFP.
CommunicateContentStartΞεκινήστε τη ροή ηχητικού περιεχομένου στη συσκευή.
CommunicateContentStopΔιακοπή ροής ηχητικού περιεχομένου.
SocketReceiveStatusΛάβετε μια ενημέρωση κατάστασης του WebSocket.

Εντολές ήχου

Ελέγξτε την ένταση του ηχείου, την ενίσχυση του μικροφώνου, τα προφίλ ήχου και την αναπαραγωγή κειμένου σε ομιλία.

AudioPlayStorageΑναπαραγωγή αρχείου ήχου από τον αποθηκευτικό χώρο της συσκευής.
AudioPlayContentΑναπαραγωγή περιεχομένου ήχου μέσω ροής.
AudioSetVolumeΡυθμίστε την ένταση ήχου εξόδου του ηχείου.

Εντολές LED

Ρυθμίστε το χρώμα, τη φωτεινότητα και τα μοτίβα κίνησης των LED στην ενδεικτική λυχνία σήματος.

DeviceIlluminationSetΡυθμίστε το χρώμα και το μοτίβο φωτισμού των LED.

Εσωτερικές εντολές

Εσωτερικές εντολές αποστολής που χρησιμοποιούνται για την παράδοση περιεχομένου, το ιστορικό καναλιών, την φωνοποίηση και την αποκωδικοποίηση ήχου.

InternalSendContextΑποστολή δεδομένων περιβάλλοντος στον εσωτερικό χειριστή περιβάλλοντος.
InternalSendChannelHistoryΑποστολή ιστορικού καναλιού στον εσωτερικό χειριστή.
InternalRequestVocalizationΑίτημα για εσωτερική φωνητική μετατροπή κειμένου σε ομιλία.
InternalHandleVocalizationRTPΧειρισμός μιας εισερχόμενης ροής RTP φωνητικής κωδικοποίησης.
InternalDecodeAudioΑποκωδικοποιήστε μια εισερχόμενη ροή ήχου.

Εντολές για κινητά

Εντολές για τον συντονισμό του σήματος με μια συζευγμένη εφαρμογή για κινητά — ειδοποιήσεις push, συγχρονισμός κατάστασης εφαρμογής και σύνδεσμοι σε βάθος.

MobileServiceStatusΑναφορά κατάστασης υπηρεσίας κινητής τηλεφωνίας στη συσκευή. (Κινητό → Συσκευή)
MobileSocketOpenΔώστε εντολή στην εφαρμογή για κινητά να ανοίξει μια σύνδεση WebSocket. (Συσκευή → Κινητό)
MobileSocketCloseΔώστε εντολή στην εφαρμογή για κινητά να κλείσει μια σύνδεση WebSocket. (Συσκευή → Κινητό)
MobileSocketStatusΑναφορά κατάστασης WebSocket στην εφαρμογή για κινητά. (Συσκευή → Κινητό)
MobileReceiveStatusΑναφορά κατάστασης λήψης στην εφαρμογή για κινητά. (Συσκευή → Κινητό)
MobileSocketUpdateΑποστολή ενημέρωσης δεδομένων WebSocket στην εφαρμογή για κινητά. (Συσκευή → Κινητό)
MobilePTTStartΕιδοποιήστε την εφαρμογή για κινητά ότι έχει ξεκινήσει η μετάδοση PTT. (Συσκευή → Κινητό)
MobilePTTStopΕιδοποιήστε την εφαρμογή για κινητά ότι η μετάδοση PTT έχει λήξει. (Συσκευή → Κινητό)
MobileContextSetΟρισμός δεδομένων περιβάλλοντος στην εφαρμογή για κινητά. (Συσκευή → Κινητό)
MobileEchoΕντολή Echo για δοκιμή συνδεσιμότητας κινητής τηλεφωνίας. (Συσκευή → Κινητό)

Έτοιμοι για κατασκευή;

Γίνετε μέλος της κοινότητας προγραμματιστών του Connection και αποκτήστε πρόσβαση σε συσκευές sandbox, SDK και ειδική υποστήριξη.

Επικοινωνήστε μαζί μας