กำหนดค่าโหมดปกติและโหมดแสงน้อย

Navigation SDK สำหรับ iOS จะไม่ติดตามโหมดสว่างและโหมดมืดของระบบ iOS โดยอัตโนมัติ แต่ที่เปิดใช้การนำทาง GMSMapView จะรองรับรูปแบบสีปกติและรูปแบบสีแสงน้อยผ่านพร็อพเพอร์ตี้ lightingMode และ Enum GMSNavigationLightingMode ดังนี้

  • โหมดปกติ (.normal): ใช้รูปแบบสีที่เหมาะกับการดูในเวลากลางวัน
  • โหมดแสงน้อย (.lowLight): ใช้รูปแบบสีที่เหมาะกับการดูในเวลากลางคืน

เปิดใช้การสลับโหมดแสงโดยอัตโนมัติ

Navigation SDK สำหรับ iOS จะคำนวณโหมดแสงที่แนะนำตามเวลาของ วันและตำแหน่งของอุปกรณ์ แล้วแสดงโหมดแสงที่แนะนำผ่าน suggestedLightingMode พร็อพเพอร์ตี้ของ GMSNavigator อย่างไรก็ตาม GMSMapView จะไม่ใช้คำแนะนำนี้โดยอัตโนมัติ

หากต้องการสลับระหว่างโหมดปกติและโหมดแสงน้อยโดยอัตโนมัติ ให้ทำตามขั้นตอนต่อไปนี้ใน View Controller

  1. ตั้งค่าโหมดแสงเริ่มต้นเมื่อเริ่มต้น: เมื่อตั้งค่าแผนที่ ให้อ่าน พร็อพเพอร์ตี้ suggestedLightingMode จาก GMSNavigator แล้วกำหนดค่าดังกล่าวให้กับ mapView.lightingMode เนื่องจาก Listener จะทำงานเมื่อโหมดแสงที่แนะนำมีการเปลี่ยนแปลงเท่านั้น (เช่น ตอนพระอาทิตย์ขึ้นหรือพระอาทิตย์ตก) การตั้งค่าเริ่มต้นจะช่วยให้แผนที่แสดงในโหมดแสงน้อยทันทีหากผู้ใช้เริ่มการนำทางในเวลากลางคืน
  2. ฟังการเปลี่ยนแปลงโหมดแสงระหว่างการนำทาง: ใช้ GMSNavigatorListener โปรโตคอลและใช้ navigator(_:didChangeSuggestedLightingMode:) เมธอดเพื่ออัปเดต mapView.lightingMode ทุกครั้งที่โหมดที่แนะนำมีการเปลี่ยนแปลง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าโหมดแสงเริ่มต้นและอัปเดตเมื่อโหมดแสงที่แนะนำมีการเปลี่ยนแปลง

Swift

// Step 1: Set the initial lighting mode on launch or setup.
mapView.navigator?.add(self)
mapView.lightingMode = mapView.navigator?.suggestedLightingMode ?? .normal

// Step 2: Update the lighting mode when the sun sets or rises during navigation.
func navigator(
  _ navigator: GMSNavigator,
  didChangeSuggestedLightingMode lightingMode: GMSNavigationLightingMode
) {
  mapView.lightingMode = lightingMode
}

Objective-C

// Step 1: Set the initial lighting mode on launch or setup.
[_mapView.navigator addListener:self];
_mapView.lightingMode = _mapView.navigator.suggestedLightingMode;

// Step 2: Update the lighting mode when the sun sets or rises during navigation.
- (void)navigator:(GMSNavigator *)navigator
    didChangeSuggestedLightingMode:(GMSNavigationLightingMode)lightingMode {
  _mapView.lightingMode = lightingMode;
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ GMSNavigatorListener, ได้ที่ การประกาศการปฏิบัติตามโปรโตคอลที่จำเป็น ในคู่มือการฟังเหตุการณ์การนำทาง

บังคับใช้โหมดปกติหรือโหมดแสงน้อย

หากไม่ต้องการให้แผนที่สลับโหมดโดยอัตโนมัติ คุณสามารถบังคับใช้โหมดปกติ หรือโหมดแสงน้อยได้โดยการตั้งค่า mapView.lightingMode โดยตรงและละเว้นการอัปเดต Listener navigator(_:didChangeSuggestedLightingMode:)

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

Swift

// Force low-light mode.
mapView.lightingMode = .lowLight

// Or force normal (daylight) mode.
mapView.lightingMode = .normal

Objective-C

// Force low-light mode.
_mapView.lightingMode = GMSNavigationLightingModeLowLight;

// Or force normal (daylight) mode.
_mapView.lightingMode = GMSNavigationLightingModeNormal;

ปรับแต่งสี UI ของโหมดแสงน้อย

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