Udhëzuesi i konfigurimit për Android

Kjo faqe ju tregon se si të konfiguroni mjedisin tuaj të zhvillimit për të përdorur MediaPipe Tasks në aplikacionet tuaja Android.

Pajisjet dhe platformat e mbështetura

Për të krijuar aplikacione Android me MediaPipe Tasks, mjedisi juaj i zhvillimit kërkon sa më poshtë:

Android Studio me një version të rekomanduar të të paktën 2021.1.1 (Bumblebee), ose një IDE tjetër të përputhshme.
Android SDK versioni 24 ose më i lartë
Pajisja Android me të paktën versionin minimal të SDK. Një emulator Android mund të mos funksionojë për të gjitha detyrat.

Konfigurimi i mjedisit të zhvilluesit

Përpara se të ekzekutoni një detyrë MediaPipe në një aplikacion Android, ose duhet të keni një aplikacion ekzistues ose të krijoni një projekt të ri Android Studio në kompjuterin tuaj lokal. MediaPipe përshtatet në shtresën e të dhënave të aplikacionit tuaj, e cila përmban të dhënat e aplikacionit dhe logjikën e biznesit. Për më shumë informacion mbi arkitekturën e aplikacionit Android, referojuni Udhëzuesit për arkitekturën e aplikacionit .

Konfigurimi i pajisjes Android

Duhet të aktivizoni opsionet e zhvilluesit dhe korrigjimin e USB-së në një pajisje fizike Android përpara se ta përdorni për të testuar aplikacionin tuaj. Për udhëzime mbi konfigurimin e pajisjes tuaj me opsionet e zhvilluesit, referojuni Konfiguro opsionet e zhvilluesit në pajisje .

Për detyrat që nuk kërkojnë një kamerë pajisjeje ose mikrofon, mund të përdorni një emulator pajisjeje Android në vend të një pajisjeje fizike Android. Për udhëzime mbi konfigurimin e një Emulatori Android, referojuni Ekzekutimi i aplikacioneve në Emulatorin Android .

Shembull i konfigurimit të kodit

Depoja e Shembujve të MediaPipe përmban shembuj të aplikacioneve Android për çdo detyrë MediaPipe. Ju mund të krijoni një projekt nga kodi shembull, të ndërtoni projektin dhe më pas ta ekzekutoni atë.

Për të importuar dhe ndërtuar shembullin e projektit të kodit:

Nisni Android Studio .
Nga Android Studio, zgjidhni Skedar > I ri > Importo projekt .
Lundroni te drejtoria e kodit shembull që përmban skedarin build.gradle dhe zgjidhni atë direktori, për shembull: .../mediapipe/examples/text_classification/android/build.gradle
Nëse Android Studio kërkon një Gradle Sync, zgjidhni OK .
Sigurohuni që pajisja juaj Android të jetë e lidhur me kompjuterin tuaj dhe se modaliteti i zhvilluesit është i aktivizuar. Klikoni shigjetën e gjelbër Run .

Nëse zgjidhni drejtorinë e duhur, Android Studio krijon një projekt të ri dhe e ndërton atë. Ky proces mund të zgjasë disa minuta, në varësi të shpejtësisë së kompjuterit tuaj dhe nëse keni përdorur Android Studio për projekte të tjera. Kur ndërtimi përfundon, Android Studio shfaq një mesazh BUILD SUCCESSFUL në panelin e statusit të Build Output .

Për të drejtuar projektin:

Nga Android Studio, ekzekutoni projektin duke zgjedhur Run > Run… .
Zgjidhni një pajisje Android (ose emulator) të bashkangjitur për të testuar aplikacionin.

Varësitë e MediaPipe Tasks

MediaPipe Tasks ofron tre biblioteka të para-ndërtuara për vizion, tekst, audio. Skedari i modelit .tflite duhet të gjendet në drejtorinë e aseteve të modulit Android që përdor modelin. Në varësi të detyrës MediaPipe të përdorur nga aplikacioni, shtoni bibliotekën e vizionit, tekstit ose audios në listën e varësive brenda skedarit build.gradle .

Detyrat gjeneruese të AI

Bibliotekat MediaPipe Tasks Generative AI përmbajnë detyra që trajtojnë gjenerimin e imazhit ose tekstit. Për të importuar bibliotekat MediaPipe Tasks Generative AI në Android Studio, shtoni varësitë në skedarin tuaj build.gradle .

Gjenerator i imazhit

Detyra MediaPipe Image Generator gjendet brenda bibliotekës tasks-vision-image-generator . Shtoni varësinë në skedarin tuaj build.gradle :

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

LLM Inference API

Detyra MediaPipe LLM Inference gjendet brenda bibliotekës tasks-genai . Shtoni varësinë në skedarin tuaj build.gradle :

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

Detyrat e vizionit

Biblioteka e vizionit të MediaPipe Tasks përmban detyra që trajtojnë hyrjet e imazheve ose videove. Për të importuar bibliotekën e vizionit të MediaPipe Tasks në Android Studio, shtoni varësitë e mëposhtme në skedarin tuaj build.gradle :

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

Detyrat e tekstit

Biblioteka e tekstit të MediaPipe Tasks përmban detyra që trajtojnë të dhënat e gjuhës në format teksti. Për të importuar bibliotekën e tekstit të MediaPipe Tasks në Android Studio, shtoni varësitë e mëposhtme në skedarin tuaj build.gradle :

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

Detyrat audio

Biblioteka audio MediaPipe Tasks përmban detyra që trajtojnë hyrjet e zërit. Për të importuar bibliotekën audio MediaPipe Tasks në Android Studio, shtoni varësitë e mëposhtme në skedarin tuaj build.gradle :

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

Konfigurimi i BaseOptions

BaseOptions lejojnë konfigurimin e përgjithshëm të MediaPipe Task API.

Emri i opsionit	Përshkrimi	Vlerat e pranuara
`modelAssetBuffer`	Skedari i asetit të modelit përmbahet si një `ByteBuffer` i drejtpërdrejtë ose një `MappedByteBuffer` .	`ByteBuffer` ose `MappedByteBuffer` si një varg
`modelAssetPath`	Rruga e modelit drejt një skedari të aseteve model në dosjen e aseteve të aplikacionit Android.	Rruga e skedarit si varg
`modelAssetFileDescriptor`	Numri i plotë i përshkruesit të skedarit vendas i një skedari të aseteve të modelit.	Numër i plotë që specifikon përshkruesin e skedarit
`Delegate`	Aktivizon përshpejtimin e harduerit përmes një delegati të pajisjes për të ekzekutuar tubacionin MediaPipe. Vlera e parazgjedhur: `CPU` .	[ `CPU` , `GPU` ]

Përshpejtimi i harduerit

MediaPipe Tasks mbështet përdorimin e njësive të përpunimit grafik (GPU) për të ekzekutuar modelet e mësimit të makinerive. Në pajisjet Android, mund të aktivizoni përdorimin e ekzekutimit të përshpejtuar nga GPU të modeleve tuaja duke përdorur një delegat. Delegatët veprojnë si drejtues harduerësh për MediaPipe, duke ju lejuar të ekzekutoni modelet tuaja në procesorë GPU në vend të procesorëve standardë të CPU.

Konfiguro delegatin e GPU-së në opsionet e detyrave përmes BaseOptions :

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

Zgjidhja e problemeve

Për ndihmë me pyetje teknike në lidhje me MediaPipe, vizitoni grupin e diskutimit ose Stack Overflow për mbështetje nga komuniteti. Për të raportuar gabime ose për të bërë kërkesa për veçori, paraqisni një problem në GitHub .

Për ndihmë në konfigurimin e mjedisit tuaj të zhvillimit të Android, vizitoni dokumentacionin e zhvilluesit të Android .