تكامل Kotlin API – توثيق ByByBG
🤖 Kotlin SDK

تكامل Kotlin

قم بدمج إزالة الخلفية بالذكاء الاصطناعي داخل تطبيقات أندرويد الأصلية باستخدام Kotlin وOkHttp ورفع الصور متعدد الأجزاء.

المقدمة

تكامل Kotlin لأندرويد

استخدم Kotlin وOkHttp لرفع الصور وإزالة الخلفيات مباشرة داخل تطبيقات أندرويد باستخدام المعالجة بالذكاء الاصطناعي.

موصى به: استخدم واجهات Proxy خلفية آمنة في تطبيقات الإنتاج لحماية بيانات اعتماد API الخاصة.
STEP 1

إضافة تبعية OkHttp

أضف مكتبة OkHttp داخل تبعيات Gradle قبل تنفيذ طلبات API.

implementation(
"com.squareup.okhttp3:okhttp:4.12.0"
)
STEP 2

استيراد الفئات المطلوبة

قم باستيراد فئات OkHttp وFile قبل إنشاء طلبات الرفع متعددة الأجزاء.

import okhttp3.*
import java.io.File
STEP 3

مثال رفع باستخدام Kotlin

قم برفع الصور واستلام نتائج PNG شفافة باستخدام Kotlin وطلبات OkHttp متعددة الأجزاء.

val client = OkHttpClient()

val file =
File("/storage/image.jpg")

val requestBody =
MultipartBody.Builder()
.setType(MultipartBody.FORM)

.addFormDataPart(

    "file",

    file.name,

    file.asRequestBody(
        "image/jpeg"
        .toMediaType()
    )

)

.build()

val request = Request.Builder()

.url(
"https://api.bybybg.com/v1/remove-bg"
)

.addHeader(
"X-API-Key",
"YOUR_API_KEY"
)

.post(requestBody)

.build()

client.newCall(request)
.enqueue(object : Callback {

    override fun onFailure(
        call: Call,
        e: IOException
    ) {

        println("Failed")

    }

    override fun onResponse(
        call: Call,
        response: Response
    ) {

        if(response.isSuccessful){

            println(
            "Background removed"
            )

        }else{

            println(
            "Error: ${response.code}"
            )

        }
    }
})
FEATURES

ميزات أندرويد الموصى بها

📷

دعم الكاميرا

التقاط الصور مباشرة باستخدام واجهات كاميرا أندرويد.

🖼️

اختيار الصور من المعرض

السماح للمستخدمين باختيار الصور من معرض الجهاز.

مؤشر التحميل

عرض مؤشرات تحميل متحركة أثناء معالجة الصور بالذكاء الاصطناعي.

💾

حفظ PNG

حفظ صور PNG الشفافة داخل ذاكرة الجهاز المحلية.

BEST PRACTICES

الممارسات الموصى بها

  • قم بضغط الصور قبل رفعها.
  • تحقق من تنسيقات الصور المدعومة.
  • تعامل مع فشل الاتصال وإعادة المحاولة.
  • لا تعرض مفاتيح API الخاصة علنًا أبدًا.
  • استخدم واجهات خلفية في بيئات الإنتاج.
ERRORS

أخطاء API الشائعة

Status
Description
401
مفتاح API غير صالح أو مفقود.
413
ملف الصورة المرفوع كبير جدًا.
429
طلبات كثيرة جدًا. تم تجاوز الحد المسموح.
500
خطأ داخلي أثناء المعالجة.

تابع إلى معالجة الأخطاء

تعرّف على حدود API ورموز الحالة وحلول المشاكل وأفضل ممارسات معالجة الأخطاء.