Gợi ý câu lệnh lập trình điều khiển trong TA Push SDK dành cho các máy chấm công kiểm soát ra vào ZKTECO

Smartid xin chia sẻ 1 số câu lệnh cơ bản để các bạn có thể tiếp cận nhanh chóng tài liệu TA Push SDK của ZKTeco điều khiển các máy chấm công vân tay khuôn mặt mới nhất. Khi các bạn đã có đủ bô tài liệu TA Push SDK  thì hoàn toàn có thể điều khiển mọi lệnh giao tiếp với các dòng máy chấm công mới nhất của hãng ZKTeco. Bộ tài liệu SDK TA Push được coi là một công cụ đặc biệt hữu ích và mạnh mẽ, giúp cho các bạn làm chủ thiết bị và tất cả các trình điều khiển giao tiếp của hãng, giúp giải pháp quản lý của các bạn tối ưu và khác biệt vượt trội so với các đơn vị không sở hữu tài liệu SDK này. Chi tiết về các hỗ trợ, các bạn vui lòng liên hệ trực tiếp với chúng tôi.

- TA Push SDK dùng ngôn ngữ phát triển nào? C# có phù hợp ko?

TA Push SDK dùng ngôn ngữ Java, tuy nhiên các bạn dùng ngôn ngữ nào không quan trọng. Chỉ cần viết API trả về theo chuẩn của nó là được.

- Lệnh lấy vân tay từ thiết bị về:

C:12345:DATA QUERY FINGERTMP PIN=1 FID=1

- Đẩy dữ liệu khuôn mặt (face) từ thiết bị lên phần mềm: Các bạn thử thao tác lệnh này:

DATA UPDATE BIODATA Pin=70059 No=0 Index=0 Valid=1 Duress=0 Type=9 MajorVer=58 MinorVer=12 Format=0 Tmp=ap

- Dùng lệnh nào để đẩy dữ liệu khuôn mặt từ server xuống các máy chấm công khác:

C:13000:DATA UPDATE BIODATA Pin=998866 No=0 Index=0 Valid=1 Duress=0 Type=9 MajorVer=5 MinorVer=621 Format=0 Tmp=bk

- Trường hợp đã đẩy dữ liệu khuôn mặt xuống máy khác, có thấy dữ liệu được đẩy xuống nhưng không chấm được?

Nguyên nhân: "Máy khác"  đó có khả năng khác về firmware, cần liên hệ Smartid để hỗ trợ trực tiếp.

- C:12345 là gì?

Là mã lệnh, thích số nào cũng được.

- Lệnh update face data cho người dùng?

C:12345:DATA UPDATE BIOPHOTO PIN=1\tContent=....................\r\n"

\r\n là để xuống dòng, mỗi lệnh trên 1 dòng, \t là dấu tab. Tùy ngôn ngữ lập trình, nếu là PHP thì dấu tap là tự thêm vào

- Lệnh set time zone:

GET OPTION FROM:
Stamp=9999
OpStamp=9999
ErrorDelay=60
Delay=30
TransTimes=00:00;14:05
TransInterval=1
TransFlag=111111111111
Realtime=1
TimeZone=7
ADMSSyncTime=1

Trường hợp máy vẫn chạy nhanh hoặc chậm hơn 1 giờ, cần thực hiện chạy lệnh tool từ máy tính để làm cho thiết bị không tự động đồng bộ nữa, vui lòng liên hệ Smartid.

- Có lệnh nào để tải toàn bộ dữ liệu user và vân tay và khuân mặt từ máy về server ?

 Dùng câu lệnh: Command: DATA QUERY USERINFO *

- Data response là dạng json hay string: Dạng String 

- Cơ chế sync data, là dữ liệu từ máy chấm công gửi đi hay từ bên ngoài gọi vào máy chấm công?

Do máy chấm công gửi đi, đẩy lên web server của nhà phát triển thông qua API

- Mẫu lệnh API: http://[yourdomain.com]/smartid/cdata?SN=xxxxxx&options=all thì yourdmain là gì:

yourdomain có thể là tên miền hoặc IP server của nhà phát triển, tức là chỉ cần một cái gì đó trên server để máy chấm công gửi về server, sau đó các bạn vào server lấy dữ liệu ra. Hệ điều hành của server là Linux hoặc Win đều được vì api là web, các bạn viết bằng gì cũng được. Trên ODOO các bạn viết API như hướng dẫn, ví dụ: http://chamcong123.com/smartid/cdata?SN=BI6R194460007&options=all, trong đó BI6R194460007 là serial của thiết bị. 

- Làm sao để set địa chỉ yourdomain cho thiết bị ?

Trên thiết bị sẽ có phần nhập như sau:

- Làm sao để gửi lệnh từ server xuống thiết bị?

Thiết bị nó tự request lên server để nhận lệnh,  có 1 cái vòng lặp định kỳ gọi lên server hỏi lệnh

- Các dòng máy  chấm công kiểm soát ra vào đang cài firmware AC (firmware mặc định của 1 số dòng máy Visible Light là AC, thiên về các tính năng kiểm soát ra vào), để phù hợp vơi TA Push SDK thì cần chuyển đổi firmware như nào?

Các bạn cần chạy tool và nhập dòng lệnh sau:

AccessRuleType=0
RegDeviceType=0
DeviceType=att

- Phần ảnh đăng ký thì tối thiểu bao nhiêu ảnh, tối đa bao nhiêu ảnh, và yêu cầu về ảnh là như nào?

Thuật toán của ZK nhận diện theo điểm ở khuôn mặt nên phải đọc từ máy chấm công lên và là 1 ảnh được mã hóa base 64. Về yêu cầu ảnh thì đẩy ảnh nào máy nó cũng nhận, tuy nhiên khuyến cáo là nên đẩy ảnh chụp chân dung và rõ mặt. Khi lấy ảnh tại máy chấm công thì đòi hỏi nhiều góc độ chụp, cái đó do máy nó mã hóa và nó trả ra một chuỗi ký tự, phần đó không can thiệp được.

- BIOPHOTO, BIODATA, FACE các mục này khác gì nhau và chức năng của từng cái?

BIOPHOTO : Hình ảnh chụp khuôn mặt đẩy vào cho máy chấm công nhận,  khi đẩy vào chấm thành công nó sẽ hiện ảnh đó
BIODATA : Đây là dữ liệu sau khi đăng ký khuôn mặt máy sẽ mã hóa ra một chuuỗi ký tự (Phần này không chỉnh được). Trong cái BioData này nó có mấy phần là BioDataTmp : Cái này máy chấm công sẽ mã hóa khi lấy khuôn mặt (Không chỉnh được); BioPhotoContent: Cái này là ảnh mã hóa theo base 64 để đẩy vào
FACE : Cái này tương tự như BioPHOTO nhưng nó dùng cho các dòng máy đời cũ

- USERPIC là gì?

Userpic giống Biophoto nhưng chỉ áp dụng cho các dòng máy chấm công ZKTeco đời cũ như Uface, IFace, MB20, MB360/160..

- Ảnh chụp tại máy khi điểm danh thành công thì lưu tại đâu và có thể lấy được không ?

Ảnh chụp tại máy điểm danh được lưu tại máy chấm công, vì dung lượng ảnh lớn nên bình thường máy chỉ lưu được giới hạn số lượng (Xem tại mục cấu hình máy chấm công phần lưu ảnh). Ảnh chấm này có thể lấy được, khi chấm công máy sẽ tự động gửi giống như dữ liệu chấm công, ảnh sẽ lưu tại ATTPHOTO

- Phần ảnh có cần resize về kích thước bao nhiêu để có thể nhận diện không?

Thiết bị chỉ chấp nhận ảnh jpg, ko chấp nhận các định dạng khác như png, webp, Chỉ chấp nhận ảnh filesize < 365kb,  chỉ chấp nhận ảnh width, height < 1366px, kích thước 600x800 là cho kết quả nhận dạng tốt nhất 

- Máy chấm tại địa chỉ ABC, IP động A (B-C), Server của bạn nằm trên cloud, tại 1 IP tĩnh X  =>Thì dữ liệu từ máy chấm sao có thể gửi từ địa chỉ ABC về cloud X?

API là trên server của các bạn, thiết bị nó như một cái máy tính, nó sẽ đẩy dữ liệu hoặc lấy dữ liệu qua API của các bạn và cloud của bạn phải có IP tĩnh hoặc tên miền.

 - Đã làm theo API như hướng dẫn và nhận được request từ máy chấm công gửi lên, nhưng chỗ log data thì chỉ thấy có SN, table, hash mà không nhận được data bên dưới ?

Cái này gửi dữ liệu theo body chứ không truyền qua POST hay GET thông thường. tùy vào ngôn ngữ lập trình để dùng lệnh, ví dụ nếu dùng python A thì dùng postman submit vào url để lấy dữ liệu là ok. Lưu ý request GET dạng String (không phải JSON) 

- Máy gửi lên lệnh này liên tục, không gửi yêu cầu gì mà máy cứ liên tục gửi lệnh như sau:

iclock/devicecmd

{"_URLCode":"iclock\/devicecmd","SN":"CKUH212360083"}ID=5440&Return=0&CMD=DATA

Response command:[{"ID":"5440","Return":"0","CMD":"DATA"}]

iclock/devicecmd
{"_URLCode":"iclock\/devicecmd","SN":"CKUH212360083"}ID=5440&Return=0&CMD=DATA

Response command:[{"ID":"5440","Return":"0","CMD":"DATA"}]

192.168.1.130 - - [25/Apr/2022:15:29:20 +0700] "POST /iclock/devicecmd?SN=CKUH212360083 HTTP/1.0" 200 0 "-" "iClock Proxy/1.09" ...

=> API này trả về chữ OK là nó hết ( Máy sẽ trả về liên tục cho đến khi nào trả về OK), các bạn check lại chắc chắn có 1 trường hợp nào lỗi không trả về OK nên nó cứ request mãi.

- Bộ tài liệu TA Push SDK lấy ở đâu ?

Vui lòng liên hệ với chúng tôi

Bài viết liên quan:

https://smartid.com.vn/zkteco-ta-push-sdk-bo-cong-cu-tich-hop-hoan-hao-cho-nha-phat-trien-giai-phap-cham-cong.html

https://smartid.com.vn/huong-dan-tich-hop-sdk-may-cham-cong-co-tinh-nang-tu-dong-day-du-lieu-qua-internetwifi3g.html

https://smartid.com.vn/ket-noi-va-dong-bo-hoa-du-lieu-cham-cong-diem-danh-tren-nen-web-based.html