Hướng dẫn thiết lập dành cho Android

Trang này cho bạn biết cách thiết lập môi trường phát triển để sử dụng MediaPipe Việc cần làm trong ứng dụng Android của bạn.

Thiết bị và nền tảng được hỗ trợ

Để tạo ứng dụng Android bằng MediaPipe Tasks, quá trình phát triển của bạn môi trường này yêu cầu:

• Android Studio với phiên bản được đề xuất ít nhất là 2021.1.1 (Bumblebee) hoặc một phiên bản tương thích khác IDE (môi trường phát triển tích hợp).
• SDK Android phiên bản 24 trở lên
• Thiết bị Android có phiên bản SDK tối thiểu. Trình mô phỏng Android có thể không dùng được cho một số tác vụ.

Thiết lập môi trường dành cho nhà phát triển

Trước khi chạy tác vụ MediaPipe trên ứng dụng Android, bạn phải có ứng dụng hiện có hoặc tạo một dự án Android Studio mới trên máy cục bộ. MediaPipe khớp với Dữ liệu của ứng dụng, chứa dữ liệu ứng dụng và logic nghiệp vụ. Để biết thêm thông tin về Cấu trúc ứng dụng Android, tham khảo Hướng dẫn về ứng dụng .

Thiết lập thiết bị Android

Bạn phải bật Tuỳ chọn cho nhà phát triển và gỡ lỗi qua USB trên một thiết bị Android thực trước khi sử dụng để kiểm thử ứng dụng. Để xem hướng dẫn về cách định cấu hình thiết bị có Tuỳ chọn cho nhà phát triển, hãy tham khảo Định cấu hình nhà phát triển trên thiết bị .

Đối với những tác vụ không yêu cầu máy ảnh hoặc micrô của thiết bị, bạn có thể sử dụng Trình mô phỏng thiết bị Android thay vì một thiết bị Android thực. Để xem hướng dẫn về cách thiết lập Trình mô phỏng Android, hãy tham khảo bài viết Chạy ứng dụng trên Android Trình mô phỏng.

Thiết lập mã ví dụ

Phương thức MediaPipe Kho lưu trữ ví dụ chứa các ứng dụng Android mẫu cho từng tác vụ MediaPipe. Bạn có thể tạo một dự án từ mã mẫu, tạo dự án rồi chạy dự án đó.

Cách nhập và tạo dự án mã mẫu:

1. Khởi động Android Studio.
2. Trong Android Studio, chọn File > (Tệp >) Mới > Nhập dự án.
3. Chuyển đến thư mục mã mẫu chứa tệp build.gradle và chọn thư mục đó, ví dụ: .../mediapipe/examples/text_classification/android/build.gradle
4. Nếu Android Studio yêu cầu Gradle Sync (Đồng bộ hoá Gradle), hãy chọn OK.
5. Đảm bảo rằng thiết bị Android đã kết nối với máy tính và nhà phát triển của bạn được bật. Nhấp vào mũi tên Run màu xanh lục.

Nếu bạn chọn đúng thư mục, Android Studio sẽ tạo một dự án mới và tạo dựng nó. Quá trình này có thể mất vài phút, tuỳ thuộc vào tốc độ của và nếu bạn đã sử dụng Android Studio cho các dự án khác. Khi bản dựng khi hoàn tất, Android Studio sẽ hiển thị thông báo BUILD SUCCESSFUL trong Bảng điều khiển trạng thái Build Output (Kết quả của bản dựng).

Cách chạy dự án:

1. Trong Android Studio, hãy chạy dự án bằng cách chọn Run > (Chạy >) Chạy....
2. Chọn một thiết bị Android (hoặc trình mô phỏng) đi kèm để kiểm thử ứng dụng.

Các phần phụ thuộc MediaPipe Tasks

MediaPipe Tasks cung cấp 3 thư viện tạo sẵn cho hình ảnh, văn bản và âm thanh. Chiến lược phát hành đĩa đơn Tệp mô hình .tflite phải nằm trong thư mục thành phần của Android mô-đun sử dụng mô hình đó. Tuỳ thuộc vào Tác vụ MediaPipe mà ứng dụng sử dụng, hãy thêm tầm nhìn, văn bản hoặc thư viện âm thanh vào danh sách các phần phụ thuộc trong Tệp build.gradle.

Nhiệm vụ dựa trên AI tạo sinh

Thư viện AI tạo sinh MediaPipe Tasks chứa các nhiệm vụ xử lý hình ảnh hoặc tạo văn bản. Cách nhập thư viện AI tạo sinh của MediaPipe Tasks vào Android Studio, hãy thêm các phần phụ thuộc vào tệp build.gradle.

Trình tạo hình ảnh

Tác vụ Trình tạo hình ảnh MediaPipe nằm trong Thư viện tasks-vision-image-generator. Thêm phần phụ thuộc vào Tệp build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

API suy luận LLM

Nhiệm vụ Suy luận LLM MediaPipe nằm trong tasks-genai thư viện của bạn. Thêm phần phụ thuộc vào tệp build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

Nhiệm vụ liên quan đến thị giác

Thư viện tầm nhìn MediaPipe Tasks chứa các nhiệm vụ xử lý hình ảnh hoặc video đầu vào. Để nhập thư viện tầm nhìn MediaPipe Tasks vào Android Studio, hãy thêm phương thức các phần phụ thuộc sau đây vào tệp build.gradle của bạn:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

Việc cần làm qua tin nhắn

Thư viện văn bản MediaPipe Tasks chứa các tác vụ xử lý dữ liệu ngôn ngữ bằng văn bản. Để nhập thư viện văn bản MediaPipe Tasks vào Android Studio, hãy thêm các phần phụ thuộc sau đây vào tệp build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-text:latest.release'
}

Tác vụ âm thanh

Thư viện âm thanh MediaPipe Tasks chứa các tác vụ xử lý đầu vào âm thanh. Người nhận nhập thư viện âm thanh MediaPipe Tasks vào Android Studio, hãy thêm đoạn mã sau phần phụ thuộc vào tệp build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-audio:latest.release'
}

Cấu hình BaseOptions

BaseOptions cho phép định cấu hình chung của các API tác vụ MediaPipe.

Tăng tốc phần cứng

MediaPipe Tasks hỗ trợ việc sử dụng các đơn vị xử lý đồ hoạ (GPU) để chạy các mô hình học máy phổ biến nhất. Trên thiết bị Android, bạn có thể cho phép sử dụng Quá trình thực thi được tăng tốc GPU cho các mô hình của bạn bằng cách sử dụng một uỷ quyền. Người được uỷ quyền có vai trò là trình điều khiển phần cứng cho MediaPipe, cho phép bạn chạy các mô hình của mình trên GPU thay vì bộ xử lý CPU tiêu chuẩn.

Định cấu hình tính năng uỷ quyền GPU trong các tuỳ chọn tác vụ thông qua BaseOptions:

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

Khắc phục sự cố

Để được trợ giúp các câu hỏi kỹ thuật liên quan đến MediaPipe, hãy truy cập cuộc thảo luận nhóm hoặc Nhóm ảnh Cơ hội bổ sung hỗ trợ từ cộng đồng. Để báo cáo lỗi hoặc đưa ra yêu cầu về tính năng, hãy gửi vấn đề lên GitHub.

Để được trợ giúp thiết lập môi trường phát triển Android, hãy truy cập vào bài viết Android tài liệu dành cho nhà phát triển.