LDPlayer ADB connect: bật ADB debugging, port và MAS

Hướng dẫn này chỉ cách kết nối LDPlayer 9 với Macro Automation Studio (MAS) qua ADB, tức bước LDPlayer ADB connect, và cách macro MAS khác với Operation Recorder của LDPlayer. LDPlayer chỉ có trên Windows, nên mọi bước LDPlayer ADB connect bên dưới đều là bước trên Windows.

Trước khi bắt đầu

• MAS đã cài và đăng nhập trên Windows 10 hoặc 11. MAS tải miễn phí để dùng thử; lấy từ trang tải.
• LDPlayer 9 đã cài từ ldplayer.net và đã khởi động một lần.
• Instance đã khởi động xong tới màn hình chính Android.
• Các ứng dụng bạn muốn tự động hóa đã cài và đăng nhập bên trong LDPlayer.

1. Cài LDPlayer 9

1. Tải LDPlayer 9 từ trang của nhà cung cấp và chạy bộ cài.
2. Khởi động LDPlayer và chờ màn hình chính.
3. Cài và đăng nhập các ứng dụng bạn muốn tự động hóa trước khi thêm thiết bị vào MAS.

2. Đặt độ phân giải cố định

MAS so khớp ảnh mẫu từng pixel, nên hãy chọn độ phân giải một lần và giữ nguyên.

1. Nhấn biểu tượng bánh răng ở thanh công cụ LDPlayer để mở Cài đặt.
2. Mở Màn hình và chọn tùy chọn độ phân giải tùy chỉnh.
3. Nhập chiều rộng 540, chiều cao 960 và DPI 240. Đây là chuẩn cơ sở của MAS; macro bạn tự viết mong đợi độ phân giải bạn đã chụp trong Asset Lab.
4. Nhấn Lưu cài đặt và khởi động lại instance khi LDPlayer yêu cầu.

3. Bật ADB debugging trong LDPlayer 9

LDPlayer đóng ADB cho đến khi bạn mở. Nhà cung cấp ghi nhận công tắc này trong Cài đặt khác:

1. Mở Cài đặt.
2. Nhấn Cài đặt khác.
3. Đặt ADB debugging thành Mở kết nối cục bộ.
4. Nhấn Lưu cài đặt.
5. Khởi động lại instance. Cài đặt có hiệu lực sau khi khởi động lại.

4. Cổng ADB của LDPlayer và cách MAS quét nó

Instance LDPlayer đầu tiên nghe trên 5555. MAS không dùng adb devices để phát hiện giả lập. Nó quét các tiến trình đang chạy và giữ một cổng khi tất cả điều sau đúng:

• Tên tiến trình chứa ldvboxheadless, ld9boxheadless, dnplayer, ldplayer hoặc vboxnetnat.
• Cổng là số lẻ và nằm giữa 5555 và 5599: 5555, 5557, 5559, và tiếp tục.
• Socket nghe trên 127.0.0.1, 0.0.0.0 hoặc mọi giao diện.

Các cổng khớp xuất hiện trong hộp thoại Thêm thiết bị mới với nhãn LD Player, ví dụ 5555 - LD Player. MAS quét khi bạn mở một nhóm thiết bị và mỗi lần bạn nhấn Làm mới. Các instance tiếp theo lấy các cổng lẻ kế tiếp, đó là lý do quy tắc chạy tới 5599: nó bao được 23 instance đang chạy.

5. LDPlayer ADB connect trong MAS

1. Mở Nhóm thiết bị ở thanh bên và mở một nhóm, hoặc tạo nhóm mới.
2. Nhấn Thêm thiết bị.
3. Gõ Tên thiết bị tối đa 50 ký tự.
4. Trong Cổng, chọn mục LD Player của instance này. Nhấn Làm mới nếu danh sách trống.
5. Nếu LDPlayer dùng một cổng không khớp quy tắc trên, chọn Cổng tùy chỉnh và gõ vào. MAS chấp nhận 1024 đến 65535.
6. Tùy chọn, chọn một Macro khởi động.
7. Nhấn Thêm thiết bị, rồi nhấn Bắt đầu trên thẻ thiết bị.

Thẻ hiển thị Đang kết nối rồi Đang chạy. MAS khởi động máy chủ adb riêng, gỡ mọi mục cũ của 127.0.0.1:<port>, và chạy adb connect tới nó.

Macro trên LDPlayer

Operation Recorder của LDPlayer (một nút trên thanh công cụ, hoặc Ctrl + 8) ghi lại cú chạm, vuốt và nhập chữ rồi phát lại thành một script. Cài đặt script của nó có Execution loop (Till loops number, Till time hoặc Till manual stop), Loop Interval và Accelerating. Thứ nó không làm được là nhìn màn hình. Mỗi cú chạm phát lại đúng tọa độ bạn đã ghi, nên một lần tải chậm, một popup hay một nút đã dời chỗ khiến cú chạm tiếp theo rơi vào khoảng không, và vòng lặp vẫn tiếp tục bất kể. Script cũng chỉ chạy bên trong LDPlayer.

Macro MAS là một đoạn mã Python kiểm tra màn hình trước khi hành động. Nó tìm nút bằng so khớp mẫu, đọc chữ bằng OCR, chờ bằng các lần thử lại, và rẽ nhánh theo những gì nó thấy. Cùng đoạn mã chạy trên LDPlayer, trên các giả lập khác và trên thiết bị cloud mà không cần sửa, vì MAS điều khiển thiết bị qua adb.

• Để dựng lại một thao tác đã ghi thành macro nhìn màn hình, làm theo Macro nhận diện hình ảnh.
• Để lặp nó cho đến khi đạt điều kiện, với điều kiện dừng mà trình ghi không diễn đạt được, hoặc chạy theo lịch, đọc Vòng lặp, điều kiện dừng và lập lịch.
• Macro từ Marketplace cài thành macro MAS và chạy trên thiết bị bạn gán.

Nhiều instance LDPlayer

Các instance tạo trong LDMultiplayer (nút Đa nhiệm trên thanh công cụ, rồi Tạo mới hoặc Nhân bản) mỗi cái nghe trên cổng riêng. Thêm từng cái làm thiết bị riêng trong cùng nhóm thiết bị, gán macro và hồ sơ cài đặt cho từng thiết bị, và dùng Bắt đầu tất cả và Dừng tất cả trên nhóm. Đặt độ phân giải cho từng instance trong Cài đặt của trình quản lý để ảnh mẫu khớp trên tất cả. Xem Nhóm thiết bị về tham số và proxy cho từng thiết bị.

Khắc phục sự cố

LDPlayer ADB device not found

Thẻ thiết bị hiển thị Lỗi với “Failed to start device”, nhật ký ghi “unable to connect to device”, hoặc MAS không liệt kê mục LD Player nào. Lần lượt xét các nguyên nhân sau:

• ADB debugging chưa đặt thành Mở kết nối cục bộ, hoặc instance chưa khởi động lại sau khi đổi. Đặt, lưu, và khởi động lại.
• Instance vẫn đang khởi động. Chờ màn hình chính, rồi nhấn Làm mới và Bắt đầu lại.
• Cổng thuộc về một instance khác. Sửa bằng Sửa thiết bị trên thẻ.
• Lần quét báo “Failed to scan emulator ports”. Khởi động lại MAS và mở lại hộp thoại.
• adb in “connection refused” hoặc “cannot connect” trong nhật ký thiết bị. Không có gì nghe trên cổng đó; chạy adb connect 127.0.0.1:5555 trong terminal để kiểm tra.

LDPlayer hiển thị offline

adb devices liệt kê 127.0.0.1:<port> offline và lệnh bị treo. Daemon adb bên trong instance đã ngừng trả lời, thường sau khi máy ngủ, cập nhật hoặc có máy chủ adb thứ hai trên máy. Nhấn Dừng trên thẻ, khởi động lại instance LDPlayer, đóng các công cụ khác chạy máy chủ adb riêng, rồi nhấn Bắt đầu. MAS ngắt mục cũ và kết nối lại ở mỗi lần bắt đầu. Nếu vẫn offline, khởi động lại MAS để máy chủ adb của nó khởi động sạch. Thêm cách sửa ở Khắc phục sự cố ADB.

Tìm cổng ADB của LDPlayer 9

Hướng dẫn ADB của nhà cung cấp không chỉ ra chỗ nào trong cài đặt LDPlayer in ra cổng, nên hãy đọc từ MAS hoặc từ adb. Trong MAS, mở Thêm thiết bị mới và nhấn Làm mới: mọi cổng tìm được đều liệt kê kèm LD Player, nhỏ nhất trước, nên instance đầu tiên là 5555 và các instance sau theo ở 5557 và 5559. Trong terminal, adb connect 127.0.0.1:5555 trả lời “connected” cho cổng đang sống và “cannot connect” cho cổng chết. Khi đã biết cổng, nó giữ nguyên miễn là bạn khởi động các instance theo cùng thứ tự.

Macro not working

Hai vấn đề khác nhau dùng chung cụm này.

• Một script LDPlayer đã ghi chạm sai chỗ hoặc lặp mà không có tác dụng. Độ phân giải đã đổi kể từ khi ghi, ứng dụng giờ tải chậm hơn, hoặc một popup nằm đè lên nút. Script đã ghi không phục hồi được từ bất kỳ tình huống nào trong số này; dựng lại thao tác thành macro MAS với Macro nhận diện hình ảnh.
• Một macro MAS đứng hoặc dừng. Mở Nhật ký trên thẻ thiết bị: ImageNotFoundError và TimeoutError nêu tên bước thất bại. Kiểm tra rằng instance chạy ở độ phân giải đã chụp ảnh mẫu, thẻ thiết bị ở Đang chạy, và không có script LDPlayer nào đang gửi thao tác cùng lúc.

Điều khiển bằng Python

Khi thẻ ở Đang chạy, src/app.py của macro điều khiển instance qua gói mas. MAS chọn cổng, nên mã không bao giờ tham chiếu tới nó.

import mas

size = mas.get_screen_size()
mas.log(f"LDPlayer screen is {size.width}x{size.height}")

match = mas.find_object_retry(1234, total_tries=3, time_sleep=2.0)
if match:
    mas.click(match.x, match.y)

Đọc Tổng quan SDK về mọi namespace, và Điều khiển giả lập Android từ Python để có đoạn mã đầu tiên hoàn chỉnh.