Nền tảng dành cho nhà phát triển

Tiếp tục phát triển
Nền tảng kết nối

Hai API mạnh mẽ — một API máy chủ RESTful để quản lý thiết bị và điều phối giao tiếp, và một giao thức CBBP cấp thấp để điều khiển trực tiếp thẻ.

Tài liệu tham khảo về API RESTGiao thức CBBP
OpenAPI 3.0JSON / RESTBluetooth + WiFiHỗ trợ 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

Quản lý toàn bộ vòng đời thiết bị — từ cấp phát, cấu hình, cập nhật firmware, truyền thông đến phân tích — thông qua giao thức HTTPS tiêu chuẩn.

Khám phá API REST →

Giao thức CBBP

Giao thức cơ bản Com Badge — một giao thức lệnh JSON để điều khiển thiết bị trực tiếp qua Bluetooth (ứng dụng), WiFi (máy chủ proxy) hoặc điều phối cục bộ.

Khám phá CBBP →

Webhooks

Đăng ký nhận các sự kiện thiết bị theo thời gian thực — thông tin liên lạc, thay đổi trạng thái, cập nhật vị trí — được gửi dưới dạng tải trọng HTTP POST đến điểm cuối của bạn.

Khám phá 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.

Bắt đầu

Xác thực

API Kết nối sử dụng xác thực bằng mã thông báo Bearer. Tất cả các yêu cầu phải bao gồm mã thông báo truy cập JWT hợp lệ trong tiêu đề Authorization.

Nhận mã thông báo

Gửi thông tin đăng nhập của bạn đến điểm cuối xác thực bằng phương thức POST. Bạn sẽ nhận được một access_token có thời hạn ngắn và một refresh_token có thời hạn dài hơn.

Sử dụng mã thông báo

Bao gồm mã thông báo trong mỗi yêu cầu:

Authorization: Bearer <access_token>
POST/api/v1/auth/login
Lời yêu cầu
{
  "email": "admin@yourorg.com",
  "password": "••••••••"
}
Phản hồi 200
{
  "access_token": "eyJhbG...",
  "refresh_token": "dGhpcw...",
  "expires_in": 3600,
  "token_type": "Bearer"
}

URL cơ sở và phiên bản

Tất cả các điểm cuối API đều được đánh số phiên bản tại /api/v1/. URL cơ sở phụ thuộc vào cấu hình triển khai của bạn.

Đối với các triển khai trên nền tảng đám mây, hãy sử dụng điểm cuối khu vực được chỉ định cho tổ chức của bạn. Đối với các triển khai máy chủ tại chỗ, hãy sử dụng tên máy chủ của bạn.

Môi trườngURL cơ sở
Đám mây (Mỹ)https://beta.connection.app/api/v1
Tại chỗhttps://<your-server>/api/v1
Loại nội dung
Tất cả nội dung yêu cầu và phản hồi đều sử dụng application/json. Hãy thêm Content-Type: application/json vào các yêu cầu có nội dung.

Lỗi & Mã trạng thái

API sử dụng các mã trạng thái HTTP tiêu chuẩn. Phản hồi lỗi bao gồm mã mà máy tính có thể đọc được và thông báo mà con người có thể đọc được.

Trạng tháiNghĩa
200Thành công
201Tạo
400Yêu cầu không hợp lệ — tham số không hợp lệ
401Không được phép — mã thông báo bị thiếu hoặc hết hạn
403Bị cấm — không đủ quyền
404Không tìm thấy
500Lỗi máy chủ nội bộ
Phản hồi lỗi
{
  "error": {
    "code": "device_not_found",
    "message": "No device with that UUID exists in your organization",
    "status": 404
  }
}
API REST

Tổng quan về API REST

API REST của Connection Server cung cấp quyền truy cập lập trình đầy đủ vào hệ thống thiết bị, cơ sở hạ tầng truyền thông và phân tích của bạn. Nó tuân theo các quy ước RESTful với phần thân yêu cầu/phản hồi dạng JSON.

Xác thực API
Người dùng
Thiết bị
Kênh
Giao tiếp
Cầu nối âm thanh
Cuộc trò chuyện
Nội dung
Địa điểm
Thông báo đẩy
Kho
Vận hành số lượng lớn
Ngày & Giờ

Xác thực

Xác thực dựa trên mã thông báo. Hàm Login trả về một mã thông báo cần được gửi dưới dạng Authorization: Token.<token> đối với tất cả các yêu cầu tiếp theo.

POST/api/v1/loginXác thực người dùng và nhận mã xác thực.
POST/api/v1/login-deviceXác thực thiết bị bằng UUID và địa chỉ MAC
POST/api/v1/logoutHủy bỏ mã thông báo phiên hiện tại

Người dùng

Tạo và quản lý tài khoản người dùng. Điểm cuối GET /users/user trả về người dùng hiện đang được xác thực.

GET/api/v1/users/userTruy xuất thông tin hồ sơ người dùng hiện đang đăng nhập
POST/api/v1/users/userTạo tài khoản người dùng mới
PATCH/api/v1/users/user/{uuid}Cập nhật hồ sơ người dùng (ví dụ: ảnh đại diện)

Thiết bị

Liệt kê và kiểm tra thiết bị, quản lý liên kết người dùng-thiết bị, đọc và ghi cài đặt và trạng thái cho từng thiết bị, xử lý ảnh firmware và ảnh lưu trữ, và nhận nhật ký và báo cáo sự cố.

GET/api/v1/devices/deviceLiệt kê tất cả các thiết bị
GET/api/v1/devices/device/{uuid}Nhận thông tin chi tiết về thiết bị, bao gồm phần mềm và cài đặt.
PUT/api/v1/devices/association/{uuid}Cập nhật liên kết giữa người dùng và thiết bị.
DELETE/api/v1/devices/association/{uuid}Xóa liên kết người dùng-thiết bị và các cài đặt đã lưu.
GET/api/v1/devices/device/{device_uuid}/settingsLiệt kê các cài đặt đã lưu cho một thiết bị.
POST/api/v1/devices/device/{device_uuid}/settingsLưu cài đặt dành riêng cho thiết bị
GET/api/v1/devices/device/{device_uuid}/statusKiểm tra trạng thái thiết bị (kết nối, pin, cảm biến, trạng thái âm thanh)
POST/api/v1/devices/device/{device_uuid}/statusĐăng trạng thái thiết bị từ thiết bị
GET/api/v1/devices/device/{device_uuid}/contextLiệt kê các giá trị ngữ cảnh được lưu trữ cho một thiết bị.
POST/api/v1/devices/device/{device_uuid}/ingest-contextNhận thông tin vị trí GPS + WiFi từ thiết bị
GET/api/v1/devices/firmwareLiệt kê các phiên bản firmware tương thích với phiên bản phần cứng/phần mềm đã cho.
GET/api/v1/devices/firmware/{uuid}/{image_type}/fetchTải ảnh firmware theo từng phần.
GET/api/v1/devices/languageLiệt kê các ngôn ngữ và giọng nói được hỗ trợ trên thiết bị.
GET/api/v1/devices/storage_imageTải xuống ảnh lưu trữ thiết bị tùy chỉnh cho một khu vực cụ thể.
POST/api/v1/devices/logNhận tệp nhật ký từ một thiết bị
POST/api/v1/devices/crashNhận bản ghi lỗi hệ thống từ một thiết bị.
PATCH/api/v1/devices/crash/{uuid}Cập nhật hồ sơ sự cố

CBBP Proxy

Gửi bất kỳ lệnh CBBP nào đến thiết bị thông qua máy chủ. Máy chủ sẽ chuyển tiếp lệnh qua kết nối WiFi của thiết bị và trả về phản hồi từ thiết bị. Phản hồi outgoing-make cũng nhúng một thông điệp CBBPMessage mà thiết bị sẽ thực thi ngay lập tức.

POST/api/v1/devices/device/{device_uuid}/cbbpGửi lệnh CBBP đến thiết bị thông qua máy chủ.
GET/api/v1/devices/device/{device_uuid}/cbbp/{uuid}Truy xuất trạng thái và phản hồi của lệnh CBBP đã gửi trước đó.

Phần thân yêu cầu là một phong bì lệnh CBBP. Đối tượng CBBPCommand được lưu trữ theo dõi trạng thái gửi: UNSET → SENT → RECEIVED hoặc TIMED_OUT.

Sử dụng lệnh Poll GET /cbbp/ để kiểm tra xem thiết bị đã nhận và phản hồi lệnh hay chưa.
Yêu cầu — tin nhắn gửi đi
{
  "outgoingMessage": {
    "command": "WiFiScan"
  }
}
Phản hồi — Trạng thái CBBPCommand
{
  "uuid": "a3f2...",
  "status": "SENT",
  "device": "d7f3a1b2-...",
  "dateSent": "2025-09-15T14:22:01Z",
  "outgoingMessage": { /* echoed */ },
  "incomingMessage": null
}

Kênh

Kênh là các thành phần cơ bản của giao tiếp. Các loại kênh bao gồm ChannelPeople, ChannelGroup, ChannelContact, ChannelContactNumber, ChannelExternalNumber, ChannelService và ChannelRecorder.

GET/api/v1/channels/channelLiệt kê các kênh, có thể lọc theo loại đối tượng.
POST/api/v1/channels/channelTạo một kênh (ChannelGroup, ChannelContact hoặc ChannelExternalNumber)
PATCH/api/v1/channels/channel/{uuid}Cập nhật ChannelGroup hoặc ChannelContact
DELETE/api/v1/channels/channel/{uuid}Xóa một kênh
DELETE/api/v1/channels/{uuid}Xóa một nhóm kênh
DELETE/api/v1/channels/by-type/{channelType}Xóa tất cả các kênh thuộc một loại nhất định (hiện tại là ChannelContact)
GET/api/v1/channels/associationLiệt kê các liên kết kênh cho người dùng hiện tại.
POST/api/v1/channels/associationYêu cầu liên kết với một kênh
PATCH/api/v1/channels/association/{uuid}Chấp nhận, từ chối hoặc cập nhật cài đặt liên kết
DELETE/api/v1/channels/association/{uuid}Xóa liên kết với một kênh
GET/api/v1/channels/historyLấy lịch sử truy cập kênh được phân trang cho người dùng hiện tại.
POST/api/v1/channels/historyTạo mục lịch sử kênh
GET/api/v1/channels/searchTìm kiếm kênh theo chuỗi truy vấn và bộ lọc loại tùy chọn

Giao tiếp

Khởi tạo và quản lý các phiên giao tiếp đang hoạt động — cuộc gọi đi, VCP, ghi âm và phát trực tuyến nội dung. Phản hồi cuộc gọi đi bao gồm một CBBPMessage mà thiết bị sẽ xử lý ngay lập tức.

POST/api/v1/communicate/outgoing-makeKhởi tạo kênh liên lạc đi tới ChannelPeople, ChannelGroup, ChannelContact hoặc ChannelContactNumber
POST/api/v1/communicate/incoming-acceptanceChấp nhận hoặc từ chối yêu cầu tham gia kênh đến
POST/api/v1/communicate/closeĐóng kênh liên lạc hiện đang hoạt động trên thiết bị.
POST/api/v1/communicate/vcp-activateKhởi tạo Giao thức Truyền thông Thoại (VCP) trên máy chủ và thiết bị.
POST/api/v1/communicate/vcp-deactivateTắt VCP, quay lại kênh trước đó.
POST/api/v1/communicate/recording-activateKích hoạt chế độ ghi trên máy chủ và thiết bị.
POST/api/v1/communicate/content-startMở kênh phát trực tuyến nội dung âm thanh
POST/api/v1/communicate/request-vocalizationTạo âm thanh TTS cho văn bản đã cho, có thể dịch văn bản đó nếu muốn.

Cầu nối âm thanh

Truy cập các bản ghi âm cuộc hội thoại qua ứng dụng Bridge, bao gồm toàn bộ bản ghi chép, danh sách người tham gia và tóm tắt do AI tạo ra. Hỗ trợ nhiều mẫu tóm tắt (ghi chú cuộc họp, ghi chú bài học, chăm sóc sức khỏe, v.v.) và tạo âm thanh TTS cho phần tóm tắt.

GET/api/v1/bridge/conversationsLiệt kê tất cả các cuộc hội thoại trên cầu
GET/api/v1/bridge/conversations/{uuid}Nhận được bản ghi chi tiết cuộc trò chuyện, bao gồm thông tin người tham gia và tóm tắt.
POST/api/v1/bridge/conversations/{conversation_uuid}/summaryTạo bản tóm tắt bằng AI cho một cuộc hội thoại
POST/api/v1/bridge/conversations/{conversation_uuid}/summary/{summary_uuid}/audioTạo bản ghi âm tóm tắt cuộc hội thoại

Cuộc trò chuyện

Phiên hội thoại được hỗ trợ bởi trí tuệ nhân tạo sử dụng ChatGPT, Gemini hoặc công cụ gốc. Hỗ trợ nhiều vai trò người dùng (Bác sĩ, Gia sư, Thợ máy, v.v.) và lịch sử tin nhắn được phân trang.

GET/api/v1/conversations/conversationLiệt kê các phiên tạo bằng AI, có thể lọc theo đối tượng và công cụ.
POST/api/v1/conversations/conversationTạo phiên hội thoại AI mới
GET/api/v1/conversations/conversation/{uuid}Truy xuất phiên hội thoại với tùy chọn tóm tắt/cập nhật trạng thái vắng mặt.
DELETE/api/v1/conversations/conversation/{uuid}Xóa phiên trò chuyện
GET/api/v1/conversations/conversation/{uuid}/messagesLiệt kê các tin nhắn trong một cuộc hội thoại
POST/api/v1/conversations/conversation/{uuid}/messagesThêm tin nhắn người dùng và nhận phản hồi từ AI

Nội dung

Duyệt và phát nội dung âm thanh trực tuyến trên các thiết bị. Nội dung được sắp xếp theo cấu trúc cây thư mục; bạn có thể lọc nội dung phổ biến theo thành phố, khu vực hoặc quốc gia.

GET/api/v1/content/categoriesTạo cây phân loại nội dung
GET/api/v1/content/contentLiệt kê nội dung có sẵn trong một danh mục
GET/api/v1/content/popularLiệt kê các nội dung phổ biến cho một thành phố, khu vực hoặc quốc gia cụ thể.

Địa điểm

Giải quyết các tọa độ địa lý thành các đối tượng có cấu trúc về thành phố, khu vực và quốc gia. Được các thiết bị sử dụng khi tiếp nhận ngữ cảnh.

POST/api/v1/location/determineXác định tọa độ vĩ độ/kinh độ thành thành phố, khu vực và quốc gia.

Thông báo đẩy

Đăng ký ứng dụng di động để nhận thông báo đẩy từ FCM. Hỗ trợ các nền tảng iOS, Android và web.

POST/api/v1/push-notifications/pushĐăng ký ứng dụng di động để nhận thông báo đẩy từ FCM (iOS, Android, web)

Kho

Tải xuống các tệp được lưu trữ trên các đối tượng mô hình và chạy chức năng xóa nền ảnh (trả về kết quả được mã hóa base64).

GET/api/v1/storage/retrieve/{path}Tải xuống tệp đã lưu theo đường dẫn
POST/api/v1/storage/remove-backgroundXóa nền khỏi hình ảnh (trả về chuỗi base64)

Vận hành số lượng lớn

Thực hiện nhiều thao tác API trong một yêu cầu HTTP duy nhất. Truyền tham số `single_transaction=true` để gói tất cả các thao tác trong một giao dịch nguyên tử duy nhất — nếu bất kỳ mục nào thất bại, toàn bộ lô giao dịch sẽ được hoàn tác.

POST/api/v1/bulkThực hiện nhiều thao tác API trong một yêu cầu duy nhất, tùy chọn dưới dạng một giao dịch nguyên tử duy nhất.

Ngày & Giờ

Trả về ngày giờ hiện tại của máy chủ theo múi giờ GMT+0. Không yêu cầu xác thực. Được các thiết bị sử dụng để đồng bộ hóa đồng hồ nội bộ của chúng.

GET/api/v1/current-datetimeTrả về ngày và giờ hiện tại theo múi giờ GMT+0.
Giao thức CBBP

Giao thức cơ bản của huy hiệu Com

CBBP là một giao thức lệnh JSON nhẹ dùng để tương tác trực tiếp với các thẻ Connection. Nó cho phép bạn kiểm soát hoàn toàn mọi chức năng phần cứng và phần mềm trên thiết bị.

Định dạng tin nhắn

Mỗi tương tác CBBP bao gồm một thông điệp lệnh được gửi đến thiết bị và một thông điệp kết quả được thiết bị trả về.

Trường đối tượng trong cả yêu cầu và phản hồi đều chứa dữ liệu cụ thể của lệnh và có thể được bỏ qua khi không cần thiết.

Tài liệu hướng dẫn đầy đủ về quy trình sẽ được cung cấp cho các đối tác đã đăng ký. Hãy liên hệ với đại diện kinh doanh của Connection hoặc liên hệ với... developer@connectionbadge.com Yêu cầu quyền truy cập vào tài liệu tham khảo đầy đủ về lệnh CBBP, bao gồm lược đồ yêu cầu/phản hồi đầy đủ, mã lỗi và hướng dẫn tích hợp.
Thông điệp lệnh
{
  "command": "command_name",
  "object": {
    // optional command parameters
  }
}
Thông báo kết quả
{
  "result": 0,          // 0 = success, -1 = error
  "detail": "ok",      // human-readable status
  "object": {          // optional response data
    // command-specific fields
  }
}

Chuyên chở

Các thông điệp CBBP có thể được gửi đến thẻ thông qua ba phương thức truyền tải khác nhau tùy thuộc vào kiến trúc tích hợp của bạn.

Bluetooth (Ứng dụng)

Gửi lệnh CBBP trực tiếp từ ứng dụng di động qua BLE. Yêu cầu thiết bị phải được ghép nối và nằm trong phạm vi kết nối.

Bộ công cụ phát triển phần mềm di động (Mobile SDK)

WiFi hoặc Bluetooth thông qua máy chủ

Thông qua API REST, máy chủ sẽ tự động định tuyến đến thiết bị bằng CBBP (Proxy CBBP) — POST /devices//cbbp. Máy chủ sẽ tự động định tuyến đến thiết bị qua WiFi hoặc Bluetooth tùy thuộc vào cách kết nối của thẻ. Phương pháp này thường được sử dụng cho các tích hợp phía máy chủ.

API REST

Điều phối nội bộ

Điều phối CBBP trên thiết bị hoặc giữa các tiến trình. Được phần mềm điều khiển của huy hiệu sử dụng để định tuyến các lệnh giữa các hệ thống con nội bộ.

Chỉ phần mềm

Lệnh nguồn

Kiểm soát trạng thái nguồn của thiết bị — chế độ ngủ, thức dậy, khởi động lại và khôi phục cài đặt gốc.

PowerRebootKhởi động lại thiết bị ngay lập tức.
PowerDeepsleepVào chế độ ngủ sâu (tiết kiệm năng lượng).
FactoryResetXóa toàn bộ cấu hình và khôi phục về cài đặt mặc định của nhà sản xuất.

Lệnh WiFi

Cấu hình mạng không dây, quét tìm điểm truy cập (AP), kiểm tra trạng thái kết nối và quản lý thông tin đăng nhập đã lưu.

WiFiScanTìm kiếm các điểm truy cập WiFi khả dụng.
WiFiAPTestKiểm tra kết nối với điểm truy cập WiFi cụ thể.
WiFiAPJoinKết nối với điểm truy cập WiFi bằng thông tin đăng nhập được cung cấp.

Lệnh Bluetooth

Kiểm soát việc quảng cáo BLE, ghép nối và giao tiếp giữa các thiết bị định vị.

BTScanBTTìm kiếm các thiết bị Bluetooth cổ điển.
BTScanBLEQuét tìm các thiết bị BLE.
DeviceBLEServiceAvailableĐánh dấu dịch vụ BLE là khả dụng.
DeviceBLEServiceUnavailableĐánh dấu dịch vụ BLE là không khả dụng.
DeviceBLEActiveĐặt bộ thu phát BLE ở trạng thái hoạt động.
DeviceBLEIdleĐặt bộ thu phát BLE về trạng thái chờ.
DeviceBLEAdvChannelAddThêm kênh vào tải trọng quảng cáo BLE.
DeviceBTScanBắt đầu quét thiết bị Bluetooth.
DeviceBTA2DStartBắt đầu phát nhạc qua Bluetooth A2DP.
DeviceBTA2DEndKết thúc truyền phát âm thanh Bluetooth A2DP.
DeviceBTNativeAssistStartKhởi động trợ lý giọng nói Bluetooth tích hợp sẵn.
DeviceBTNativeAssistEndTắt trợ lý giọng nói Bluetooth mặc định.

Lệnh cài đặt

Đọc và ghi cấu hình thiết bị — tên hiển thị, múi giờ, ngôn ngữ và các cờ tính năng.

SettingsListGetTruy xuất tất cả các thiết lập dưới dạng danh sách cặp khóa-giá trị.
SettingsListSetNhập nhiều giá trị cài đặt cùng một lúc.
SettingsGetLấy giá trị của một thiết lập duy nhất theo khóa.
SettingsSetĐặt giá trị cho một thiết lập duy nhất.
SettingsSendĐẩy các cài đặt hiện tại lên máy chủ.
SettingsClearXóa các giá trị cài đặt cụ thể.
SettingsEraseXóa tất cả cài đặt đã lưu.

Lệnh phần mềm

Kích hoạt cập nhật firmware OTA, kiểm tra trạng thái cập nhật và truy vấn phiên bản firmware hiện tại trên thiết bị.

FirmwareCheckKiểm tra xem có bản cập nhật phần mềm nào khả dụng không.
FirmwareUpdateBắt đầu cập nhật firmware qua mạng.
FirmwareValidateKiểm tra tính toàn vẹn của ảnh firmware đã tải xuống.

Lệnh thiết bị

Vòng đời thiết bị, xác thực, cấu hình, ghi nhật ký, trạng thái và điều khiển phần cứng.

NoOpKhông hoạt động / duy trì sự sống.
TestKiểm tra kết nối cơ bản.
DeviceDateTimeLấy hoặc thiết lập ngày giờ của thiết bị.
DeviceAuthenticateXác thực thiết bị với máy chủ.
DeviceConfigureÁp dụng gói cấu hình vào thiết bị.
DevicePostConnectionTasksThực hiện các tác vụ khởi tạo sau khi kết nối.
DeviceStorageLoadTải dữ liệu từ bộ nhớ trên thiết bị.
DeviceLoadCustomAudioTải các tệp âm thanh tùy chỉnh lên thiết bị.
DeviceCoredumpSendTải tệp kết xuất lỗi hệ thống lên máy chủ.
DeviceAttachKết nối thiết bị với phiên máy chủ.
DeviceDetachNgắt kết nối thiết bị khỏi phiên máy chủ.
DeviceLogSendTải nhật ký thiết bị lên máy chủ.
DeviceConnectionTestKiểm tra kết nối máy chủ.
DeviceStatusSendĐẩy trạng thái thiết bị lên máy chủ.
DeviceStatusGetLấy trạng thái hiện tại của thiết bị.
DeviceInteractionKích hoạt sự kiện tương tác thiết bị.
DeviceSetAPIHostThiết lập máy chủ API.
DeviceTestMicsChạy thử nghiệm tự động của micro.
HardwareI2CCommandGửi lệnh I2C thô đến thiết bị ngoại vi phần cứng.

Lệnh liên lạc

Thực hiện cuộc gọi, gửi tin nhắn, quản lý các phiên giao tiếp đang hoạt động và điều khiển ghi âm.

CommunicateChannelJoinHãy tham gia kênh giao tiếp.
CommunicateChannelLeaveHãy duy trì kênh liên lạc.
CommunicateChannelChangeHãy chuyển sang kênh khác.
CommunicateChannelCloseĐóng kênh liên lạc.
CommunicateReceiveIncomingThông báo cho thiết bị về việc có thông tin liên lạc đến.
CommunicateRequestOutgoingYêu cầu gửi thông tin đi.
CommunicateVCPActivateKích hoạt phiên giao tiếp bằng giọng nói.
CommunicateVCPDeactivateHủy kích hoạt phiên VCP.
CommunicateRecordingActivateBắt đầu ghi âm lại quá trình giao tiếp đang diễn ra.
CommunicateIncomingAcceptNhận cuộc gọi đến.
CommunicateIncomingRejectTừ chối cuộc gọi đến.
CommunicateHFPCallStartBắt đầu cuộc gọi điện thoại Bluetooth HFP.
CommunicateHFPCallEndKết thúc cuộc gọi điện thoại Bluetooth HFP.
CommunicateContentStartBắt đầu phát nội dung âm thanh đến thiết bị.
CommunicateContentStopHãy ngừng phát trực tuyến nội dung âm thanh.
SocketReceiveStatusNhận thông báo cập nhật trạng thái qua WebSocket.

Lệnh âm thanh

Điều chỉnh âm lượng loa, độ nhạy micro, cấu hình âm thanh và phát lại văn bản thành giọng nói.

AudioPlayStoragePhát tệp âm thanh từ bộ nhớ trên thiết bị.
AudioPlayContentPhát nội dung âm thanh trực tuyến.
AudioSetVolumeĐiều chỉnh âm lượng đầu ra của loa.

Lệnh LED

Thiết lập màu sắc, độ sáng và kiểu hoạt ảnh cho đèn báo hiệu trên huy hiệu.

DeviceIlluminationSetThiết lập màu sắc và kiểu chiếu sáng của đèn LED.

Lệnh nội bộ

Các lệnh điều phối nội bộ được sử dụng để cung cấp ngữ cảnh, lịch sử kênh, phát âm và giải mã âm thanh.

InternalSendContextGửi dữ liệu ngữ cảnh đến trình xử lý ngữ cảnh nội bộ.
InternalSendChannelHistoryGửi lịch sử kênh đến trình xử lý nội bộ.
InternalRequestVocalizationYêu cầu chuyển văn bản thành giọng nói nội bộ.
InternalHandleVocalizationRTPXử lý luồng RTP âm thanh giọng nói đến.
InternalDecodeAudioGiải mã luồng âm thanh đến.

Lệnh di động

Các lệnh để phối hợp huy hiệu với ứng dụng di động được ghép nối — thông báo đẩy, đồng bộ trạng thái ứng dụng và liên kết sâu.

MobileServiceStatusBáo cáo trạng thái dịch vụ di động cho thiết bị. (Di động → Thiết bị)
MobileSocketOpenHướng dẫn ứng dụng trên thiết bị di động mở kết nối WebSocket. (Thiết bị → Di động)
MobileSocketCloseHướng dẫn ứng dụng di động đóng kết nối WebSocket. (Thiết bị → Di động)
MobileSocketStatusBáo cáo trạng thái WebSocket cho ứng dụng di động. (Thiết bị → Di động)
MobileReceiveStatusBáo cáo trạng thái nhận được trên ứng dụng di động. (Thiết bị → Di động)
MobileSocketUpdateGửi bản cập nhật dữ liệu WebSocket đến ứng dụng di động. (Thiết bị → Di động)
MobilePTTStartThông báo cho ứng dụng trên thiết bị di động rằng quá trình truyền tín hiệu PTT đã bắt đầu. (Thiết bị → Di động)
MobilePTTStopThông báo cho ứng dụng trên thiết bị di động rằng quá trình truyền tín hiệu PTT đã kết thúc. (Thiết bị → Di động)
MobileContextSetThiết lập dữ liệu ngữ cảnh trên ứng dụng di động. (Thiết bị → Di động)
MobileEchoLệnh Echo để kiểm tra kết nối di động. (Thiết bị → Di động)

Sẵn sàng xây dựng chưa?

Hãy tham gia cộng đồng nhà phát triển Connection và nhận quyền truy cập vào các thiết bị thử nghiệm, SDK và hỗ trợ chuyên dụng.

Liên hệ với chúng tôi