ประกาศบริการที่ทำงานอยู่เบื้องหน้าและขอสิทธิ์

ในไฟล์ Manifest ของแอป ให้ประกาศบริการที่ทำงานอยู่เบื้องหน้าแต่ละรายการของแอป ด้วยองค์ประกอบ <service> สำหรับแต่ละบริการ ให้ใช้แอตทริบิวต์ android:foregroundServiceType เพื่อประกาศประเภทงานที่บริการนั้นๆ ทำ

นอกจากนี้ ให้ขอสิทธิ์ที่บริการที่ทำงานอยู่เบื้องหน้าต้องการ

ความเข้ากันได้ของเวอร์ชัน

ข้อกำหนดในการประกาศบริการที่ทำงานอยู่เบื้องหน้าและขอ สิทธิ์จะแตกต่างกันไปตามระดับ API ที่แอปกำหนดเป้าหมาย หน้านี้ อธิบายข้อกำหนดสำหรับแอปที่กำหนดเป้าหมายเป็น API ระดับ 34 ขึ้นไป ดูข้อมูลเกี่ยวกับการเปลี่ยนแปลงบริการที่ทำงานอยู่เบื้องหน้าในแพลตฟอร์มเวอร์ชันก่อนหน้าได้ที่การเปลี่ยนแปลงบริการที่ทำงานอยู่เบื้องหน้า

ประกาศบริการที่ทำงานอยู่เบื้องหน้าในไฟล์ Manifest ของแอป

โค้ดต่อไปนี้แสดงวิธีประกาศบริการที่ทำงานอยู่เบื้องหน้าสำหรับการเล่นสื่อ คุณอาจใช้บริการเช่นนี้เพื่อเปิดเพลง

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>
  <application ...>

    <service
        android:name=".MyMediaPlaybackService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="false">
    </service>
  </application>
</manifest>

ประเด็นสำคัญเกี่ยวกับโค้ด

  • ในตัวอย่างนี้ บริการมีเพียงประเภทเดียวคือ media หากบริการของคุณมีหลายประเภท ให้แยกแต่ละประเภทด้วยตัวดำเนินการ | เช่น หากบริการใช้กล้องและไมโครโฟน ให้ประกาศดังนี้

    android:foregroundServiceType="camera|microphone"

  • คุณอาจต้องประกาศบริการที่ทำงานอยู่เบื้องหน้าในไฟล์ Manifest ของแอป ทั้งนี้ขึ้นอยู่กับระดับ API ที่แอปกำหนดเป้าหมาย ข้อกำหนดสำหรับ API ระดับที่เฉพาะเจาะจงจะอธิบายไว้ในการเปลี่ยนแปลงบริการที่ทำงานอยู่เบื้องหน้า

    หากคุณพยายามสร้างบริการที่ทำงานอยู่เบื้องหน้าและไม่ได้ประกาศประเภทของบริการในไฟล์ Manifest ระบบจะแสดงMissingForegroundServiceTypeException เมื่อเรียกใช้ startForeground()

    แม้ว่าจะไม่บังคับ แต่แนวทางปฏิบัติแนะนำคือการประกาศ บริการที่ทำงานอยู่เบื้องหน้าทั้งหมดและระบุประเภทบริการ

ขอสิทธิ์สำหรับบริการที่ทำงานอยู่เบื้องหน้า

โค้ดต่อไปนี้แสดงวิธีขอสิทธิ์สำหรับบริการที่ทำงานอยู่เบื้องหน้า ซึ่งใช้กล้อง

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CAMERA"/>

    <application ...>
        ...
    </application>
</manifest>

ประเด็นสำคัญเกี่ยวกับโค้ด

  • โค้ดนี้ใช้แนวทางปฏิบัติแนะนำสำหรับแอปที่กำหนดเป้าหมายเป็น API ระดับ 34 ขึ้นไป