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

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

รูปที่ 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

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

วิดีโอ

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

ตัวอย่าง

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