ขอสิทธิ์เข้าถึงตำแหน่งขณะรันไทม์

เมื่อฟีเจอร์ในแอปของคุณต้องใช้สิทธิ์เข้าถึงตำแหน่ง ให้รอจนกว่าผู้ใช้จะโต้ตอบกับฟีเจอร์นั้นก่อนที่จะส่งคำขอสิทธิ์ เวิร์กโฟลว์นี้เป็นไปตามแนวทางปฏิบัติแนะนำในการขอสิทธิ์รันไทม์ตามบริบท ตามที่อธิบายไว้ในคู่มือที่อธิบายวิธีขอสิทธิ์ของแอป

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

ผู้ใช้ให้สิทธิ์ได้เฉพาะตำแหน่งโดยประมาณ

ใน Android 12 (API ระดับ 31) ขึ้นไป ผู้ใช้จะขอให้แอปของคุณดึงข้อมูลตำแหน่งโดยประมาณเท่านั้นได้ แม้ว่าแอปจะขอสิทธิ์รันไทม์ ACCESS_FINE_LOCATION ก็ตาม

หากต้องการจัดการพฤติกรรมที่ผู้ใช้อาจทำเช่นนี้ อย่าขอสิทธิ์ ACCESS_FINE_LOCATION เพียงอย่างเดียว แต่ให้ขอทั้งสิทธิ์ ACCESS_FINE_LOCATION และสิทธิ์ ACCESS_COARSE_LOCATION ในคำขอรันไทม์เดียว หากคุณพยายามขอเฉพาะ ACCESS_FINE_LOCATION ระบบจะไม่สนใจคำขอใน Android 12 บางรุ่น หากแอปกำหนดเป้าหมายเป็น Android 12 ขึ้นไป ระบบจะบันทึกข้อความแสดงข้อผิดพลาดต่อไปนี้ใน Logcat

ACCESS_FINE_LOCATION must be requested with ACCESS_COARSE_LOCATION.

เมื่อแอปขอทั้ง ACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION กล่องโต้ตอบสิทธิ์ของระบบจะมีตัวเลือกต่อไปนี้ให้ผู้ใช้

• แน่นอน: อนุญาตให้แอปรับข้อมูลตำแหน่งที่แน่นอน
• โดยประมาณ: อนุญาตให้แอปรับข้อมูลตำแหน่งโดยประมาณเท่านั้น

รูปที่ 3 แสดงให้เห็นว่ากล่องโต้ตอบมีรูปภาพบอกใบ้สำหรับทั้ง 2 ตัวเลือกเพื่อช่วยผู้ใช้ในการเลือก หลังจากเลือกความแม่นยำของตำแหน่งแล้ว ผู้ใช้จะแตะปุ่มใดปุ่มหนึ่งจาก 3 ปุ่มเพื่อเลือกระยะเวลาการให้สิทธิ์

ใน Android 12 ขึ้นไป ผู้ใช้สามารถไปที่การตั้งค่าระบบเพื่อตั้งค่าความแม่นยำของตำแหน่งที่ต้องการสำหรับแอปใดก็ได้ โดยไม่คำนึงถึงเวอร์ชัน SDK เป้าหมายของแอปนั้น การดำเนินการนี้จะยังคงมีผลอยู่แม้ว่าผู้ใช้จะติดตั้งแอปในอุปกรณ์ที่ใช้ Android 11 หรือต่ำกว่า และอัปเกรดอุปกรณ์เป็น Android 12 ขึ้นไปก็ตาม

ตัวเลือกของผู้ใช้ส่งผลต่อการให้สิทธิ์

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

หากต้องการดูว่าระบบให้สิทธิ์ใดแก่แอปของคุณ ให้ตรวจสอบค่าที่แสดงผลของคำขอสิทธิ์ คุณสามารถใช้ไลบรารี Jetpack ในโค้ดที่คล้ายกับโค้ดต่อไปนี้ หรือจะใช้ไลบรารีแพลตฟอร์มก็ได้ ซึ่งคุณจัดการโค้ดคำขอสิทธิ์ด้วยตนเอง

@RequiresApi(Build.VERSION_CODES.N)
fun requestPermissions() {
    val locationPermissionRequest = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permissions ->
        when {
            permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false) -> {
                // Precise location access granted.
            }
            permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false) -> {
                // Only approximate location access granted.
            }
            else -> {
                // No location access granted.
            }
        }
    }

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions:
    // https://developer.android.com/training/permissions/requesting#request-permission
    locationPermissionRequest.launch(
        arrayOf(
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
        )
    )
}
LocationPermissionsActivity.kt

private void requestPermissions() {

    ActivityResultLauncher<String[]> locationPermissionRequest =
            registerForActivityResult(new ActivityResultContracts
                            .RequestMultiplePermissions(), result -> {

                Boolean fineLocationGranted = null;
                Boolean coarseLocationGranted = null;

                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
                    fineLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_FINE_LOCATION, false);
                    coarseLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_COARSE_LOCATION,false);
                }

                if (fineLocationGranted != null && fineLocationGranted) {
                    // Precise location access granted.
                } else if (coarseLocationGranted != null && coarseLocationGranted) {
                    // Only approximate location access granted.
                } else {
                    // No location access granted.
                }
            }
        );

    // ...

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions.
    locationPermissionRequest.launch(new String[] {
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
    });
}
LocationPermissionsActivityJava.java

ขออัปเกรดเป็นตำแหน่งที่แน่นอน

คุณสามารถขอให้ผู้ใช้อัปเกรดสิทธิ์เข้าถึงของแอปจากตําแหน่งโดยประมาณเป็นตําแหน่งแม่นยํา อย่างไรก็ตาม ก่อนที่จะขอให้ผู้ใช้อัปเกรดสิทธิ์เข้าถึงตำแหน่งที่แม่นยำของแอป ให้พิจารณาว่า Use Case ของแอปจำเป็นต้องใช้ความแม่นยำระดับนี้จริงๆ หรือไม่ หากแอปของคุณต้องจับคู่อุปกรณ์กับอุปกรณ์ที่อยู่ใกล้เคียงผ่านบลูทูธหรือ Wi-Fi ให้พิจารณาใช้การจับคู่อุปกรณ์ที่ใช้ร่วมกันหรือสิทธิ์บลูทูธแทนการขอสิทธิ์ ACCESS_FINE_LOCATION

หากต้องการขอให้ผู้ใช้อัปเกรดการเข้าถึงตำแหน่งของแอปจากแบบใกล้เคียงเป็นแบบแม่นยำ ให้ทำดังนี้

1. อธิบายเหตุผลที่แอปของคุณต้องใช้สิทธิ์ หากจำเป็น
2. ขอสิทธิ์ ACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION พร้อมกันอีกครั้ง เนื่องจากผู้ใช้ได้อนุญาตให้ระบบมอบสิทธิ์เข้าถึงตำแหน่งโดยประมาณแก่แอปของคุณแล้ว กล่องโต้ตอบของระบบจึงแตกต่างออกไปในครั้งนี้ ดังที่แสดงในรูปที่ 4 และรูปที่ 5

ขอตำแหน่งเบื้องหน้าเท่านั้นในตอนแรก

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

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

กระบวนการส่งคำขอเพิ่มเติมมีดังนี้

1. ในตอนแรก แอปควรแนะนำผู้ใช้ไปยังฟีเจอร์ที่ต้องเข้าถึงตำแหน่งในเบื้องหน้า เช่น ฟีเจอร์ "แชร์ตำแหน่ง" ในรูปที่ 1 หรือฟีเจอร์ "แสดงตำแหน่งปัจจุบัน" ในรูปที่ 2

   เราขอแนะนำให้คุณปิดใช้สิทธิ์ของผู้ใช้ในการเข้าถึงฟีเจอร์ที่ต้องเข้าถึงตำแหน่งในเบื้องหลังจนกว่าแอปจะมีสิทธิ์เข้าถึงตำแหน่งในเบื้องหน้า

2. ในภายหลังเมื่อผู้ใช้สำรวจฟีเจอร์ที่ต้องเข้าถึงตำแหน่งในเบื้องหลัง คุณสามารถขอสิทธิ์เข้าถึงตำแหน่งในเบื้องหลังได้

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์เข้าถึงตำแหน่งใน Android ได้ที่เนื้อหาต่อไปนี้

Codelabs

• แนวทางปฏิบัติแนะนำด้านความเป็นส่วนตัว

วิดีโอ

• วิธีค้นหาการใช้งานตำแหน่งในเบื้องหลังที่เป็นไปได้

ตัวอย่าง

• แอปตัวอย่างเพื่อสาธิตการใช้สิทธิ์เข้าถึงตำแหน่ง