Cloud phone Android: tạo, xem trực tiếp và chạy macro

Thiết bị cloud là một cloud phone Android mà Macro Automation Studio (MAS) chạy cho bạn trên các máy chủ GPU của MAS. Cloud phone Android này nằm cạnh các giả lập local của bạn trong ứng dụng, truyền màn hình qua WebRTC, và chạy macro phía máy chủ, nên máy tính của bạn có thể tắt. Trang này nói về cách tạo, các trạng thái, ứng dụng, lần chạy và giới hạn.

Trước khi bắt đầu

• MAS đã cài và bạn đã đăng nhập. Xem Cài đặt MAS.
• Gói của bạn có ít nhất một thiết bị cloud. Thiết bị cloud là phần bổ sung cho gói trả phí; xem Thanh toán.
• Để chạy: một macro Python trong thư viện của bạn. Hộp thoại chạy chỉ liệt kê macro Python.

Cloud phone Android là gì

Mỗi thiết bị cloud là một thiết bị Android đầy đủ trong trung tâm dữ liệu của MAS, được kết xuất trên GPU máy chủ. Bắt đầu và dừng mất thời gian thật: khoảng 48 giây cho lần khởi động mới, 17 giây để tiếp tục và 9 giây để dừng. Màn hình đến với bạn dưới dạng luồng WebRTC mang video và các cú chạm của bạn, và mỗi lúc chỉ một người xem giữ được luồng; thẻ hiển thị biểu tượng con mắt, Đang được xem trực tiếp, khi nó đang mở ở nơi khác. Macro chạy trên máy chủ MAS ngay cạnh thiết bị, nên đóng ứng dụng không kết thúc lần chạy. Ứng dụng đã cài và tài khoản đã đăng nhập vẫn còn sau khi dừng; chỉ Xóa mới xóa chúng.

Tạo thiết bị cloud

1. Mở Thiết bị cloud ở thanh bên.
2. Gõ Tên thiết bị.
3. Chọn phiên bản Android. Danh sách đến từ máy chủ; Android 15 là mặc định.
4. Chọn Độ phân giải: Light (540 x 960), Standard (720 x 1280) hoặc Sharp (1080 x 1920). Sharp truyền gấp đôi số pixel và cần nhiều băng thông hơn.
5. Chọn DPI, hoặc giữ Mặc định, mật độ riêng của preset. Các giá trị cho phép là 160, 240, 320 và 480.
6. Tùy chọn, tích Kèm CH Play (xem bên dưới).
7. Nhấn Tạo.

Thiết bị xuất hiện ở trạng thái Đã dừng; tạo không đồng nghĩa với khởi động. Phiên bản, độ phân giải và DPI cố định sau khi tạo, nên muốn cấu hình khác thì phải tạo thiết bị mới. Tiêu đề trang đếm số thiết bị Đang chạy và Đã cấp so với gói của bạn, và mỗi tài khoản có thể giữ tối đa 20 thiết bị cloud.

CH Play trên cloud phone Android

Ứng dụng Google là tùy chọn theo từng thiết bị. Tích Kèm CH Play khi tạo thiết bị, hoặc nhấn Thêm CH Play trên thiết bị đã có: thiết bị khởi động lại một lần, trong khoảng 15 giây, và giữ nguyên dữ liệu. Thêm CH Play cho tất cả áp dụng cho mọi thiết bị chưa có.

Lần đầu, MAS hiển thị tuyên bố miễn trừ Cài ứng dụng Google, bạn chấp nhận một lần cho mỗi tài khoản. Tóm tắt: thiết bị cài MindTheGapps, một gói mã nguồn mở độc lập do các nhà phát triển LineageOS duy trì, chứa cửa hàng CH Play, dịch vụ Play Services và Google Services Framework. MAS không liên kết, không được chứng thực hay cấp phép bởi Google; cả MAS lẫn dự án MindTheGapps đều không cấp cho bạn giấy phép nào với các ứng dụng của Google, và việc bạn dùng ứng dụng Google cũng như bất kỳ tài khoản Google nào chịu sự điều chỉnh của Điều khoản dịch vụ của Google. Thiết bị ảo không được chứng nhận Play Protect, nên các ứng dụng xác minh tính toàn vẹn thiết bị sẽ không hoạt động: ứng dụng ngân hàng và thanh toán, Google Wallet, phát trực tuyến HD hoặc có DRM, và một số game. Bạn cài và dùng ứng dụng Google với rủi ro của riêng mình.

Thiết bị có CH Play hiển thị huy hiệu Play. Nếu cài thất bại, thẻ đưa ra Thử lại.

Trạng thái thiết bị

Mọi chuyển đổi đều bất đồng bộ; thẻ hiển thị thời gian đã trôi qua trong lúc thiết bị đang chuyển.

Bắt đầu, dừng và xóa

• Bắt đầu khởi động thiết bị. Khi mọi chỗ chạy trong gói của bạn đã dùng hết, nó thất bại với thông báo kiểu “2 trên 2 đang chạy, dừng một cái để bắt đầu cái khác”.
• Dừng giải phóng chỗ chạy cùng GPU và RAM của máy chủ nhưng giữ ổ đĩa. Bắt đầu tiếp tục nó.
• Xóa hủy thiết bị và mọi thứ trên đó: ứng dụng đã cài, tài khoản đã đăng nhập, tiến trình game. Hộp thoại nói rõ trước.

Thiết bị đang chạy mà không có lần chạy nào sẽ tự dừng sau 60 phút. Dữ liệu được giữ; Bắt đầu tiếp tục nó trong vài giây. Một macro đang chạy giữ thiết bị bật.

Xem màn hình trực tiếp

Nhấn Xem trên thiết bị sẵn sàng. Đang thương lượng luồng nghĩa là kết nối WebRTC đang được thiết lập; khi đã trực tiếp, cú nhấp, kéo và phím của bạn đi thẳng tới thiết bị, và tiêu đề đưa ra Toàn màn hình, Quay lại, Trang chủ và Đóng. Đóng trình xem giải phóng luồng cho cửa sổ khác. Trong Nhóm thiết bị, thẻ thiết bị cloud có Xem trực tiếp, gắn cùng trình xem đó bên cạnh thẻ.

Cài ứng dụng

Nhấn Cài APK trên thiết bị sẵn sàng. Hộp chọn đưa ra ba cách:

• Tải lên tệp (.apk / .xapk): tệp .apk, .xapk, .apkm hoặc .apks tối đa 1 GiB. MAS kiểm tra, tải lên máy chủ của thiết bị và cài ở đó. Các định dạng chứa được giải nén, các split 32-bit và x86 bị bỏ, tệp mở rộng được đặt đúng chỗ, và phần còn lại cài như một gói. Gói không có bản arm64 bị từ chối trước khi tải lên; thiết bị cloud chỉ chạy ARM 64-bit.
• Tìm ứng dụng để tải: gõ tên ứng dụng, hoặc dán liên kết hay id gói, rồi nhấn Cài. MAS tải ứng dụng về máy tính này và cài theo cùng cách.
• Quản lý ứng dụng đã cài: xem những gì có trên thiết bị, Cập nhật một ứng dụng khi danh mục có bản mới hơn, hoặc gỡ bằng nút thùng rác (nhấn hai lần để xác nhận). Tiêu đề hiển thị số chỗ ứng dụng đã dùng so với giới hạn của thiết bị.

Tiến độ hiển thị trên thẻ: Đang kiểm tra ứng dụng, Đang tải ứng dụng lên, Đang cài ứng dụng. Thất bại hiển thị nguyên văn lý do, gồm cả các mã INSTALL_FAILED của adb.

Chạy macro 24/7 trên cloud phone

1. Bắt đầu thiết bị và chờ Sẵn sàng.
2. Nhấn Chạy trên thẻ và chọn một macro Python.
3. Theo dõi dòng chạy: đang khởi chạy, đang chạy kèm thời gian đã trôi, đã xong hoặc thất bại. Dừng lần chạy kết thúc lần chạy và để thiết bị bật.

Trước khi lần chạy bắt đầu, MAS đồng bộ mã của bạn: nó băm thư mục dự án của macro và chỉ tải lên bản chụp khi cây thư mục thay đổi. Một bản chụp chứa tối đa 500 tệp và 10 MiB sau khi nén; các thư mục bắt đầu bằng dấu chấm như .git và .venv, cùng __pycache__, node_modules, venv và tệp .pyc, đều bị bỏ qua. Dự án vượt giới hạn thất bại trước khi chạy kèm lý do, ví dụ “project has more than 500 files”. Bản chụp là thứ cloud chạy, nên cây làm việc của Code Editor được thực thi mà không cần commit hay push. Xem Dự án git và đồng bộ mã.

Các lần chạy bắt đầu từ một nhóm thiết bị cloud dùng macro của thiết bị cùng tham số hoặc hồ sơ cài đặt của nó, và hiển thị đầu ra của mã trong thẻ. Mọi lần chạy đều vào Lần chạy kèm trạng thái.

Nhóm thiết bị cloud và proxy

Một nhóm thiết bị chứa một loại thiết bị. Tạo nhóm với Loại đặt là Cloud, nhấn Thêm thiết bị cloud và chọn một thiết bị đã cấp; thiết bị cloud chỉ vào được nhóm cloud. Mỗi thiết bị trong nhóm có macro, tham số hoặc hồ sơ cài đặt, proxy và webhook riêng, và Bắt đầu tất cả khởi chạy lần lượt một lần chạy phía máy chủ cho mỗi thiết bị. Xem Nhóm thiết bị.

Proxy gắn với thiết bị cloud được áp dụng bên trong mạng của thiết bị ở lần khởi động tiếp theo, nên mọi lưu lượng của nó đi ra qua proxy và thẻ hiển thị IP đầu ra. Xem Proxy.

REST API và MCP

Với một khóa API, bạn có thể bắt đầu và theo dõi các lần chạy phía máy chủ: POST /api/hosted/devices/{id}/run với macro_id và args tùy chọn, POST /api/hosted/runs/{id}/stop, GET /api/hosted/runs/{id}, cùng GET /api/macros/{id}/code-state và POST /api/macros/{id}/code-snapshot để đồng bộ mã. Vòng đời thiết bị, truyền phát và cài ứng dụng cần đăng nhập của chính ứng dụng. Xem REST API. Máy chủ MCP của MAS đưa thiết bị cloud tới các client MCP.

Chi phí

Thiết bị cloud là phần bổ sung cho mọi gói trả phí, tính theo từng thiết bị mỗi tháng, kèm hạn mức credit AI hằng tháng cho MAS Agent. Thêm hoặc bớt thiết bị giữa chu kỳ; thay đổi được tính theo tỷ lệ và ngày gia hạn giữ nguyên. Xem trang giá và Thanh toán.

Khắc phục sự cố

Thiết bị kẹt ở đang bố trí hoặc đang khởi động

Đang bố trí nghĩa là chưa có máy chủ nào còn chỗ. MAS cấp một máy chủ mới, mất khoảng 15 phút, và thiết bị tự chuyển tiếp. Nếu không có gì trống trong vòng 45 phút, thiết bị chuyển sang Lỗi với “no capacity became available”, và Bắt đầu thử lại. Lần khởi động đầu thường xong dưới 1:30 và tiếp tục dưới 0:20; nếu thời gian đã trôi vượt xa mức đó, nhấn Dừng, chờ Đã dừng, rồi Bắt đầu lại. Việc đó cũng chuyển thiết bị sang máy chủ hiện hành, sửa được lỗi “this device’s host does not support APK installs yet”.

Luồng không kết nối

• Thiết bị phải ở Sẵn sàng. Thiết bị đã dừng trả lời “The device must be running before you can view it”.
• Kẹt ở Đang thương lượng luồng: vé luồng có thời hạn ngắn, nên đóng trình xem và nhấn Xem lại, hoặc nhấn Kết nối lại khi được đưa ra.
• Đang mở ở nơi khác: một người xem giữ luồng. Đóng nó ở cửa sổ hoặc instance MAS kia.
• Mạng chặn WebRTC sẽ không bao giờ hiện video. Thử mạng khác, rồi hỏi trong Discord.

Cài ứng dụng thất bại

• “this package has no arm64-v8a build”: ứng dụng chỉ có mã 32-bit hoặc x86. Lấy bản arm64.
• “not a valid APK”: tệp không phải gói Android hoặc bị hỏng.
• “the limit is 1024MB”: gói vượt quá 1 GiB.
• “INSTALL_FAILED_MISSING_SPLIT”: gói không đầy đủ. Tải XAPK đầy đủ và cài bản đó.
• “install timed out”: máy chủ đang quá tải. Thử lại sau vài phút.