iOS MapBox：切换地图固定朝北与跟随设备方向功能异常排查

问题核心 #

你当前的代码中，切换到朝北模式时仅手动设置了相机朝向，但Viewport的跟随Puck状态仍在后台运行，设备旋转时会自动覆盖你的手动相机设置，导致地图继续跟随设备方向。

解决方案 #

要完全解除地图与设备旋转的绑定，必须先终止当前活跃的Viewport状态，再设置固定朝北的相机参数。具体操作：

• 切换到朝北模式时，调用mapView.viewport.stop()停止Viewport的自动更新逻辑
• 切换回跟随模式时，重新启动跟随Puck的Viewport状态

修改后的代码 #

var showsToNorth = false

override func viewDidLoad() {
    super.viewDidLoad()
    
    ...
    // 地图打开时开始根据设备方向旋转地图
    mapView.viewport.transition(to: mapView.viewport.makeFollowPuckViewportState(options: .init(pitch: 0)))
    ...
}   

@objc
func currentLocationButtonAction() {
    showsToNorth.toggle()
    if showsToNorth {
        // 停止Viewport自动更新，解除设备方向与地图旋转的绑定
        mapView.viewport.stop()
        
        var cameraOption = CameraOptions(cameraState: mapView.cameraState)
        cameraOption.bearing = 0
        cameraOption.center = mapView.location.latestLocation?.coordinate
        mapView.camera.ease(to: cameraOption, duration: 0)
    } else {
        // 重新启动跟随设备方向的Viewport状态
        mapView.viewport.transition(to: mapView.viewport.makeFollowPuckViewportState(options: .init(pitch: 0)))
    }
}

额外优化（可选） #

如果希望定位Puck本身也不跟随设备方向，可以在朝北模式下添加：

mapView.location.options.puckBearingEnabled = false

切换回跟随模式时再恢复：

mapView.location.options.puckBearingEnabled = true

内容的提问来源于stack exchange，提问作者Arthur Avagyan