expo-gaode-map-navigation 2.0.10 → 2.0.11

package/android/src/main/res/drawable/nav_notification_brand_icon.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="96dp"
+    android:height="96dp"
+    android:viewportWidth="96"
+    android:viewportHeight="96">
+    <path
+        android:fillColor="#3F5BDB"
+        android:pathData="M48,4a44,44 0,1 0,0 88a44,44 0,1 0,0 -88z" />
+    <path
+        android:fillColor="#6E84EB"
+        android:pathData="M48,12a36,36 0,1 0,0 72a36,36 0,1 0,0 -72z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M48,24c-10.5,0 -19,8.5 -19,19c0,14.2 19,31 19,31s19,-16.8 19,-31c0,-10.5 -8.5,-19 -19,-19zM48,50c-4.1,0 -7.5,-3.4 -7.5,-7.5c0,-4.1 3.4,-7.5 7.5,-7.5c4.1,0 7.5,3.4 7.5,7.5c0,4.1 -3.4,7.5 -7.5,7.5z" />
+</vector>

package/android/src/main/res/drawable/navi_lane_shape_bg_center.xml

@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape android:shape="rectangle"
-  xmlns:android="http://schemas.android.com/apk/res/android">
-    <solid android:color="#ff0091ff" />
+<?xml version="1.0" encoding="utf-8"?>
+<shape android:shape="rectangle"
+  xmlns:android="http://schemas.android.com/apk/res/android">
+    <solid android:color="#ff0091ff" />
 </shape>

package/android/src/main/res/drawable/navi_lane_shape_bg_left.xml

@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <corners
-        android:bottomLeftRadius="3dp"
-        android:topLeftRadius="3dp" />
-    <solid android:color="#ff0091ff" />
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <corners
+        android:bottomLeftRadius="3dp"
+        android:topLeftRadius="3dp" />
+    <solid android:color="#ff0091ff" />
 </shape>

package/android/src/main/res/drawable/navi_lane_shape_bg_over.xml

@@ -1,6 +1,6 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <corners android:radius="3dp" />
-    <solid android:color="#ff0091ff" />
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <corners android:radius="3dp" />
+    <solid android:color="#ff0091ff" />
 </shape>

package/android/src/main/res/drawable/navi_lane_shape_bg_right.xml

@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <corners
-        android:bottomRightRadius="3dp"
-        android:topRightRadius="3dp" />
-    <solid android:color="#ff0091ff" />
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <corners
+        android:bottomRightRadius="3dp"
+        android:topRightRadius="3dp" />
+    <solid android:color="#ff0091ff" />
 </shape>

package/build/ExpoGaodeMapNaviView.d.ts

@@ -9,7 +9,11 @@ export interface ExpoGaodeMapNaviViewRef {
      */
     startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;
     /**
-     * 使用独立路径组启动导航
+     * 在当前嵌入式导航视图中，使用独立路径组启动导航
+     *
+     * - 依赖当前 ExpoGaodeMapNaviView 实例
+     * - 适合“路线选择页 -> 进入嵌入式导航页”这类页面内流程
+     * - 若不依赖嵌入式导航视图，可改用模块级 startNaviWithIndependentPath(...)
      */
     startNavigationWithIndependentPath: (token: number, options?: {
         routeId?: number;
@@ -20,6 +24,10 @@ export interface ExpoGaodeMapNaviViewRef {
      * 停止导航
      */
     stopNavigation: () => Promise<void>;
+    /**
+     * 播放自定义 TTS
+     */
+    playCustomTTS: (text: string, forcePlay?: boolean) => Promise<void>;
 }
 /**
  * 高德导航视图组件

package/build/ExpoGaodeMapNaviView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNaviView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAU1B,MAAM,SAAS,CAAC;AAcjB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F;;OAEG;IACH,kCAAkC,EAAE,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAsCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,2GAkG/B,CAAC;AAIH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ExpoGaodeMapNaviView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAU1B,MAAM,SAAS,CAAC;AAuCjB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F;;;;;;OAMG;IACH,kCAAkC,EAAE,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,2GA6H/B,CAAC;AAIH,eAAe,oBAAoB,CAAC"}

package/build/ExpoGaodeMapNaviView.js

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { Image, Platform, StatusBar } from 'react-native';
+import { Image, PermissionsAndroid, Platform, StatusBar, } from 'react-native';
 import { createLazyNativeViewManager } from './map/utils/lazyNativeViewManager';
 function normalizeNaviImageSource(source) {
     if (source == null) {
@@ -10,6 +10,21 @@ function normalizeNaviImageSource(source) {
     }
     return Image.resolveAssetSource(source)?.uri;
 }
+async function ensureAndroidNavigationNotificationPermission(enabled) {
+    if (!enabled || Platform.OS !== 'android' || Platform.Version < 33) {
+        return;
+    }
+    try {
+        const permission = PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS;
+        const granted = await PermissionsAndroid.check(permission);
+        if (!granted) {
+            await PermissionsAndroid.request(permission);
+        }
+    }
+    catch (error) {
+        console.warn('[expo-gaode-map-navigation] Failed to request POST_NOTIFICATIONS permission automatically.', error);
+    }
+}
 const getNativeView = createLazyNativeViewManager('ExpoGaodeMapNaviView');
 /**
  * 高德导航视图组件
@@ -46,8 +61,9 @@ const getNativeView = createLazyNativeViewManager('ExpoGaodeMapNaviView');
  */
 export const ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
     const nativeRef = React.useRef(null);
+    const hasRequestedAndroidNotificationPermissionRef = React.useRef(false);
     const NativeView = React.useMemo(() => getNativeView(), []);
-    const { onNaviInfoUpdate, onNaviStart, onNaviEnd, onArrive, onReCalculate, onPlayVoice, onNaviVisualStateChange, onLaneInfoUpdate, onTrafficStatusesUpdate, carImage, fourCornersImage, carCompassImage, startPointImage, wayPointImage, endPointImage, cameraImage, androidStatusBarPaddingTop, ...restProps } = props;
+    const { onNaviInfoUpdate, onNaviStart, onNaviEnd, onArrive, onReCalculate, onPlayVoice, onNaviVisualStateChange, onLaneInfoUpdate, onTrafficStatusesUpdate, isNightMode, mapViewModeType, carImage, fourCornersImage, carCompassImage, startPointImage, wayPointImage, endPointImage, cameraImage, androidStatusBarPaddingTop, ...restProps } = props;
     const resolvedAndroidStatusBarPaddingTop = Platform.OS === 'android' &&
         androidStatusBarPaddingTop == null &&
         props.showUIElements !== false &&
@@ -61,6 +77,7 @@ export const ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
     const resolvedWayPointImage = normalizeNaviImageSource(wayPointImage);
     const resolvedEndPointImage = normalizeNaviImageSource(endPointImage);
     const resolvedCameraImage = normalizeNaviImageSource(cameraImage);
+    const resolvedMapViewModeType = mapViewModeType ?? (isNightMode == null ? undefined : (isNightMode ? 1 : 0));
     const platformSpecificImageProps = Platform.OS === 'android'
         ? {
             fourCornersImage: resolvedFourCornersImage,
@@ -69,6 +86,20 @@ export const ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
             carCompassImage: resolvedCarCompassImage,
             cameraImage: resolvedCameraImage,
         };
+    React.useEffect(() => {
+        if (Platform.OS !== 'android') {
+            return;
+        }
+        if (!props.androidBackgroundNavigationNotificationEnabled) {
+            hasRequestedAndroidNotificationPermissionRef.current = false;
+            return;
+        }
+        if (hasRequestedAndroidNotificationPermissionRef.current) {
+            return;
+        }
+        hasRequestedAndroidNotificationPermissionRef.current = true;
+        void ensureAndroidNavigationNotificationPermission(true);
+    }, [props.androidBackgroundNavigationNotificationEnabled]);
     // 创建 API 引用
     const apiRef = React.useMemo(() => ({
         startNavigation: async (start, end, type) => {
@@ -91,10 +122,15 @@ export const ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
                 throw new Error('ExpoGaodeMapNaviView not initialized');
             return nativeRef.current.stopNavigation();
         },
+        playCustomTTS: async (text, forcePlay = false) => {
+            if (!nativeRef.current)
+                throw new Error('ExpoGaodeMapNaviView not initialized');
+            return nativeRef.current.playCustomTTS(text, forcePlay);
+        },
     }), []);
     // 暴露 API 给外部 ref
     React.useImperativeHandle(ref, () => apiRef, [apiRef]);
-    return (<NativeView ref={nativeRef} {...restProps} androidStatusBarPaddingTop={resolvedAndroidStatusBarPaddingTop} carImage={resolvedCarImage} startPointImage={resolvedStartPointImage} wayPointImage={resolvedWayPointImage} endPointImage={resolvedEndPointImage} {...platformSpecificImageProps} onNavigationInfoUpdate={onNaviInfoUpdate} onNavigationStarted={onNaviStart} onNavigationEnded={onNaviEnd} onArriveDestination={onArrive} onRouteRecalculate={onReCalculate} onNavigationText={onPlayVoice} onNavigationVisualStateUpdate={onNaviVisualStateChange} onLaneInfoUpdate={onLaneInfoUpdate} onTrafficStatusesUpdate={onTrafficStatusesUpdate}/>);
+    return (<NativeView ref={nativeRef} {...restProps} androidStatusBarPaddingTop={resolvedAndroidStatusBarPaddingTop} mapViewModeType={resolvedMapViewModeType} carImage={resolvedCarImage} startPointImage={resolvedStartPointImage} wayPointImage={resolvedWayPointImage} endPointImage={resolvedEndPointImage} {...platformSpecificImageProps} onNavigationInfoUpdate={onNaviInfoUpdate} onNavigationStarted={onNaviStart} onNavigationEnded={onNaviEnd} onArriveDestination={onArrive} onRouteRecalculate={onReCalculate} onNavigationText={onPlayVoice} onNavigationVisualStateUpdate={onNaviVisualStateChange} onLaneInfoUpdate={onLaneInfoUpdate} onTrafficStatusesUpdate={onTrafficStatusesUpdate}/>);
 });
 ExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';
 export default ExpoGaodeMapNaviView;

package/build/ExpoGaodeMapNaviView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNaviView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\nimport type {\n  Coordinates,\n  ExpoGaodeMapNaviViewProps,\n  NaviArriveEvent,\n  NaviEndEvent,\n  NaviInfoUpdateEvent,\n  NaviLaneInfoEvent,\n  NaviStartEvent,\n  NaviTrafficStatusesEvent,\n  NaviVisualStateEvent,\n  PlayVoiceEvent,\n  ReCalculateEvent,\n} from './types';\nimport { Image, Platform, StatusBar, type NativeSyntheticEvent } from 'react-native';\nimport { createLazyNativeViewManager } from './map/utils/lazyNativeViewManager';\n\nfunction normalizeNaviImageSource(source?: ExpoGaodeMapNaviViewProps['carImage']): string | undefined {\n  if (source == null) {\n    return undefined;\n  }\n  if (typeof source === 'string') {\n    return source;\n  }\n  return Image.resolveAssetSource(source)?.uri;\n}\n\n/**\n * ExpoGaodeMapNaviView Ref 类型\n */\nexport interface ExpoGaodeMapNaviViewRef {\n  /**\n   * 开始导航\n   */\n  startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;\n  /**\n   * 使用独立路径组启动导航\n   */\n  startNavigationWithIndependentPath: (\n    token: number,\n    options?: {\n      routeId?: number;\n      routeIndex?: number;\n      naviType?: number;\n    }\n  ) => Promise<void>;\n  \n  /**\n   * 停止导航\n   */\n  stopNavigation: () => Promise<void>;\n}\n\ninterface NativeExpoGaodeMapNaviViewRef {\n  startNavigation: (\n    startLatitude: number,\n    startLongitude: number,\n    endLatitude: number,\n    endLongitude: number\n  ) => Promise<void>;\n  startNavigationWithIndependentPath: (\n    token: number,\n    routeId?: number,\n    routeIndex?: number,\n    naviType?: number\n  ) => Promise<void>;\n  stopNavigation: () => Promise<void>;\n}\n\ninterface NativeExpoGaodeMapNaviViewProps\n  extends ExpoGaodeMapNaviViewProps {\n  ref?: React.Ref<NativeExpoGaodeMapNaviViewRef>;\n  onNavigationInfoUpdate?: (event: NativeSyntheticEvent<NaviInfoUpdateEvent>) => void;\n  onNavigationStarted?: (event: NativeSyntheticEvent<NaviStartEvent>) => void;\n  onNavigationEnded?: (event: NativeSyntheticEvent<NaviEndEvent>) => void;\n  onArriveDestination?: (event: NativeSyntheticEvent<NaviArriveEvent>) => void;\n  onRouteRecalculate?: (event: NativeSyntheticEvent<ReCalculateEvent>) => void;\n  onNavigationText?: (event: NativeSyntheticEvent<PlayVoiceEvent>) => void;\n  onNavigationVisualStateUpdate?: (event: NativeSyntheticEvent<NaviVisualStateEvent>) => void;\n  onLaneInfoUpdate?: (event: NativeSyntheticEvent<NaviLaneInfoEvent>) => void;\n  // Unified traffic-segment event used by the library traffic bar and any\n  // consumer that wants to render a fully custom traffic beam.\n  onTrafficStatusesUpdate?: (event: NativeSyntheticEvent<NaviTrafficStatusesEvent>) => void;\n}\n\nconst getNativeView = createLazyNativeViewManager<\n  NativeExpoGaodeMapNaviViewProps\n>('ExpoGaodeMapNaviView');\n\n/**\n * 高德导航视图组件\n *\n * 使用高德官方的导航界面，提供完整的导航体验，包括：\n * - 路线规划和显示\n * - 实时导航信息（距离、时间、道路名称）\n * - 转向箭头和提示\n * - 路况信息\n * - 摄像头提示\n * - 语音播报\n *\n * @example\n * ```tsx\n * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';\n *\n * function NavigationScreen() {\n *   return (\n *     <ExpoGaodeMapNaviView\n *       style={{ flex: 1 }}\n *       naviType={0} // GPS 导航\n *       showCamera={true}\n *       enableVoice={true}\n *       onNaviInfoUpdate={(e) => {\n *         console.log('剩余距离:', e.nativeEvent.pathRetainDistance);\n *       }}\n *       onArrive={() => {\n *         console.log('到达目的地！');\n *       }}\n *     />\n *   );\n * }\n * ```\n */\nexport const ExpoGaodeMapNaviView = React.forwardRef<ExpoGaodeMapNaviViewRef, ExpoGaodeMapNaviViewProps>((props, ref) => {\n  const nativeRef = React.useRef<NativeExpoGaodeMapNaviViewRef | null>(null);\n  const NativeView = React.useMemo(() => getNativeView(), []);\n  const {\n    onNaviInfoUpdate,\n    onNaviStart,\n    onNaviEnd,\n    onArrive,\n    onReCalculate,\n    onPlayVoice,\n    onNaviVisualStateChange,\n    onLaneInfoUpdate,\n    onTrafficStatusesUpdate,\n    carImage,\n    fourCornersImage,\n    carCompassImage,\n    startPointImage,\n    wayPointImage,\n    endPointImage,\n    cameraImage,\n    androidStatusBarPaddingTop,\n    ...restProps\n  } = props;\n\n  const resolvedAndroidStatusBarPaddingTop =\n    Platform.OS === 'android' &&\n    androidStatusBarPaddingTop == null &&\n    props.showUIElements !== false &&\n    props.hideNativeTopInfoLayout !== true\n      ? (StatusBar.currentHeight ?? 0)\n      : androidStatusBarPaddingTop;\n  const resolvedCarImage = normalizeNaviImageSource(carImage);\n  const resolvedFourCornersImage = normalizeNaviImageSource(fourCornersImage);\n  const resolvedCarCompassImage = normalizeNaviImageSource(carCompassImage);\n  const resolvedStartPointImage = normalizeNaviImageSource(startPointImage);\n  const resolvedWayPointImage = normalizeNaviImageSource(wayPointImage);\n  const resolvedEndPointImage = normalizeNaviImageSource(endPointImage);\n  const resolvedCameraImage = normalizeNaviImageSource(cameraImage);\n  const platformSpecificImageProps =\n    Platform.OS === 'android'\n      ? {\n          fourCornersImage: resolvedFourCornersImage,\n        }\n      : {\n          carCompassImage: resolvedCarCompassImage,\n          cameraImage: resolvedCameraImage,\n        };\n  \n  // 创建 API 引用\n  const apiRef: ExpoGaodeMapNaviViewRef = React.useMemo(() => ({\n    startNavigation: async (start: Coordinates | null, end: Coordinates, type: number) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      // 将对象解构为单独的参数传递给原生层\n      const startLat = start?.latitude ?? 0;\n      const startLng = start?.longitude ?? 0;\n      const endLat = end.latitude;\n      const endLng = end.longitude;\n      return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);\n    },\n    startNavigationWithIndependentPath: async (token, options) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.startNavigationWithIndependentPath(\n        token,\n        options?.routeId,\n        options?.routeIndex,\n        options?.naviType\n      );\n    },\n    stopNavigation: async () => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.stopNavigation();\n    },\n  }), []);\n  \n  // 暴露 API 给外部 ref\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n  \n  return (\n    <NativeView\n      ref={nativeRef}\n      {...restProps}\n      androidStatusBarPaddingTop={resolvedAndroidStatusBarPaddingTop}\n      carImage={resolvedCarImage}\n      startPointImage={resolvedStartPointImage}\n      wayPointImage={resolvedWayPointImage}\n      endPointImage={resolvedEndPointImage}\n      {...platformSpecificImageProps}\n      onNavigationInfoUpdate={onNaviInfoUpdate}\n      onNavigationStarted={onNaviStart}\n      onNavigationEnded={onNaviEnd}\n      onArriveDestination={onArrive}\n      onRouteRecalculate={onReCalculate}\n      onNavigationText={onPlayVoice}\n      onNavigationVisualStateUpdate={onNaviVisualStateChange}\n      onLaneInfoUpdate={onLaneInfoUpdate}\n      onTrafficStatusesUpdate={onTrafficStatusesUpdate}\n    />\n  );\n});\n\nExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';\n\nexport default ExpoGaodeMapNaviView;\n"]}
+{"version":3,"file":"ExpoGaodeMapNaviView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\nimport type {\n  Coordinates,\n  ExpoGaodeMapNaviViewProps,\n  NaviArriveEvent,\n  NaviEndEvent,\n  NaviInfoUpdateEvent,\n  NaviLaneInfoEvent,\n  NaviStartEvent,\n  NaviTrafficStatusesEvent,\n  NaviVisualStateEvent,\n  PlayVoiceEvent,\n  ReCalculateEvent,\n} from './types';\nimport {\n  Image,\n  PermissionsAndroid,\n  Platform,\n  StatusBar,\n  type NativeSyntheticEvent,\n} from 'react-native';\nimport { createLazyNativeViewManager } from './map/utils/lazyNativeViewManager';\n\nfunction normalizeNaviImageSource(source?: ExpoGaodeMapNaviViewProps['carImage']): string | undefined {\n  if (source == null) {\n    return undefined;\n  }\n  if (typeof source === 'string') {\n    return source;\n  }\n  return Image.resolveAssetSource(source)?.uri;\n}\n\nasync function ensureAndroidNavigationNotificationPermission(enabled: boolean): Promise<void> {\n  if (!enabled || Platform.OS !== 'android' || Platform.Version < 33) {\n    return;\n  }\n\n  try {\n    const permission = PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS;\n    const granted = await PermissionsAndroid.check(permission);\n    if (!granted) {\n      await PermissionsAndroid.request(permission);\n    }\n  } catch (error) {\n    console.warn(\n      '[expo-gaode-map-navigation] Failed to request POST_NOTIFICATIONS permission automatically.',\n      error\n    );\n  }\n}\n\n/**\n * ExpoGaodeMapNaviView Ref 类型\n */\nexport interface ExpoGaodeMapNaviViewRef {\n  /**\n   * 开始导航\n   */\n  startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;\n  /**\n   * 在当前嵌入式导航视图中，使用独立路径组启动导航\n   *\n   * - 依赖当前 ExpoGaodeMapNaviView 实例\n   * - 适合“路线选择页 -> 进入嵌入式导航页”这类页面内流程\n   * - 若不依赖嵌入式导航视图，可改用模块级 startNaviWithIndependentPath(...)\n   */\n  startNavigationWithIndependentPath: (\n    token: number,\n    options?: {\n      routeId?: number;\n      routeIndex?: number;\n      naviType?: number;\n    }\n  ) => Promise<void>;\n  \n  /**\n   * 停止导航\n   */\n  stopNavigation: () => Promise<void>;\n\n  /**\n   * 播放自定义 TTS\n   */\n  playCustomTTS: (text: string, forcePlay?: boolean) => Promise<void>;\n}\n\ninterface NativeExpoGaodeMapNaviViewRef {\n  startNavigation: (\n    startLatitude: number,\n    startLongitude: number,\n    endLatitude: number,\n    endLongitude: number\n  ) => Promise<void>;\n  startNavigationWithIndependentPath: (\n    token: number,\n    routeId?: number,\n    routeIndex?: number,\n    naviType?: number\n  ) => Promise<void>;\n  stopNavigation: () => Promise<void>;\n  playCustomTTS: (text: string, forcePlay?: boolean) => Promise<void>;\n}\n\ninterface NativeExpoGaodeMapNaviViewProps\n  extends ExpoGaodeMapNaviViewProps {\n  ref?: React.Ref<NativeExpoGaodeMapNaviViewRef>;\n  onNavigationInfoUpdate?: (event: NativeSyntheticEvent<NaviInfoUpdateEvent>) => void;\n  onNavigationStarted?: (event: NativeSyntheticEvent<NaviStartEvent>) => void;\n  onNavigationEnded?: (event: NativeSyntheticEvent<NaviEndEvent>) => void;\n  onArriveDestination?: (event: NativeSyntheticEvent<NaviArriveEvent>) => void;\n  onRouteRecalculate?: (event: NativeSyntheticEvent<ReCalculateEvent>) => void;\n  onNavigationText?: (event: NativeSyntheticEvent<PlayVoiceEvent>) => void;\n  onNavigationVisualStateUpdate?: (event: NativeSyntheticEvent<NaviVisualStateEvent>) => void;\n  onLaneInfoUpdate?: (event: NativeSyntheticEvent<NaviLaneInfoEvent>) => void;\n  // Unified traffic-segment event used by the library traffic bar and any\n  // consumer that wants to render a fully custom traffic beam.\n  onTrafficStatusesUpdate?: (event: NativeSyntheticEvent<NaviTrafficStatusesEvent>) => void;\n}\n\nconst getNativeView = createLazyNativeViewManager<\n  NativeExpoGaodeMapNaviViewProps\n>('ExpoGaodeMapNaviView');\n\n/**\n * 高德导航视图组件\n *\n * 使用高德官方的导航界面，提供完整的导航体验，包括：\n * - 路线规划和显示\n * - 实时导航信息（距离、时间、道路名称）\n * - 转向箭头和提示\n * - 路况信息\n * - 摄像头提示\n * - 语音播报\n *\n * @example\n * ```tsx\n * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';\n *\n * function NavigationScreen() {\n *   return (\n *     <ExpoGaodeMapNaviView\n *       style={{ flex: 1 }}\n *       naviType={0} // GPS 导航\n *       showCamera={true}\n *       enableVoice={true}\n *       onNaviInfoUpdate={(e) => {\n *         console.log('剩余距离:', e.nativeEvent.pathRetainDistance);\n *       }}\n *       onArrive={() => {\n *         console.log('到达目的地！');\n *       }}\n *     />\n *   );\n * }\n * ```\n */\nexport const ExpoGaodeMapNaviView = React.forwardRef<ExpoGaodeMapNaviViewRef, ExpoGaodeMapNaviViewProps>((props, ref) => {\n  const nativeRef = React.useRef<NativeExpoGaodeMapNaviViewRef | null>(null);\n  const hasRequestedAndroidNotificationPermissionRef = React.useRef(false);\n  const NativeView = React.useMemo(() => getNativeView(), []);\n  const {\n    onNaviInfoUpdate,\n    onNaviStart,\n    onNaviEnd,\n    onArrive,\n    onReCalculate,\n    onPlayVoice,\n    onNaviVisualStateChange,\n    onLaneInfoUpdate,\n    onTrafficStatusesUpdate,\n    isNightMode,\n    mapViewModeType,\n    carImage,\n    fourCornersImage,\n    carCompassImage,\n    startPointImage,\n    wayPointImage,\n    endPointImage,\n    cameraImage,\n    androidStatusBarPaddingTop,\n    ...restProps\n  } = props;\n\n  const resolvedAndroidStatusBarPaddingTop =\n    Platform.OS === 'android' &&\n    androidStatusBarPaddingTop == null &&\n    props.showUIElements !== false &&\n    props.hideNativeTopInfoLayout !== true\n      ? (StatusBar.currentHeight ?? 0)\n      : androidStatusBarPaddingTop;\n  const resolvedCarImage = normalizeNaviImageSource(carImage);\n  const resolvedFourCornersImage = normalizeNaviImageSource(fourCornersImage);\n  const resolvedCarCompassImage = normalizeNaviImageSource(carCompassImage);\n  const resolvedStartPointImage = normalizeNaviImageSource(startPointImage);\n  const resolvedWayPointImage = normalizeNaviImageSource(wayPointImage);\n  const resolvedEndPointImage = normalizeNaviImageSource(endPointImage);\n  const resolvedCameraImage = normalizeNaviImageSource(cameraImage);\n  const resolvedMapViewModeType = mapViewModeType ?? (isNightMode == null ? undefined : (isNightMode ? 1 : 0));\n  const platformSpecificImageProps =\n    Platform.OS === 'android'\n      ? {\n          fourCornersImage: resolvedFourCornersImage,\n        }\n      : {\n          carCompassImage: resolvedCarCompassImage,\n          cameraImage: resolvedCameraImage,\n        };\n\n  React.useEffect(() => {\n    if (Platform.OS !== 'android') {\n      return;\n    }\n\n    if (!props.androidBackgroundNavigationNotificationEnabled) {\n      hasRequestedAndroidNotificationPermissionRef.current = false;\n      return;\n    }\n\n    if (hasRequestedAndroidNotificationPermissionRef.current) {\n      return;\n    }\n\n    hasRequestedAndroidNotificationPermissionRef.current = true;\n    void ensureAndroidNavigationNotificationPermission(true);\n  }, [props.androidBackgroundNavigationNotificationEnabled]);\n  \n  // 创建 API 引用\n  const apiRef: ExpoGaodeMapNaviViewRef = React.useMemo(() => ({\n    startNavigation: async (start: Coordinates | null, end: Coordinates, type: number) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      // 将对象解构为单独的参数传递给原生层\n      const startLat = start?.latitude ?? 0;\n      const startLng = start?.longitude ?? 0;\n      const endLat = end.latitude;\n      const endLng = end.longitude;\n      return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);\n    },\n    startNavigationWithIndependentPath: async (token, options) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.startNavigationWithIndependentPath(\n        token,\n        options?.routeId,\n        options?.routeIndex,\n        options?.naviType\n      );\n    },\n    stopNavigation: async () => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.stopNavigation();\n    },\n    playCustomTTS: async (text, forcePlay = false) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.playCustomTTS(text, forcePlay);\n    },\n  }), []);\n  \n  // 暴露 API 给外部 ref\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n  \n  return (\n    <NativeView\n      ref={nativeRef}\n      {...restProps}\n      androidStatusBarPaddingTop={resolvedAndroidStatusBarPaddingTop}\n      mapViewModeType={resolvedMapViewModeType}\n      carImage={resolvedCarImage}\n      startPointImage={resolvedStartPointImage}\n      wayPointImage={resolvedWayPointImage}\n      endPointImage={resolvedEndPointImage}\n      {...platformSpecificImageProps}\n      onNavigationInfoUpdate={onNaviInfoUpdate}\n      onNavigationStarted={onNaviStart}\n      onNavigationEnded={onNaviEnd}\n      onArriveDestination={onArrive}\n      onRouteRecalculate={onReCalculate}\n      onNavigationText={onPlayVoice}\n      onNavigationVisualStateUpdate={onNaviVisualStateChange}\n      onLaneInfoUpdate={onLaneInfoUpdate}\n      onTrafficStatusesUpdate={onTrafficStatusesUpdate}\n    />\n  );\n});\n\nExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';\n\nexport default ExpoGaodeMapNaviView;\n"]}

package/build/index.d.ts

@@ -47,31 +47,54 @@ export declare const calculateMotorcycleRoute: (options: MotorcycleRouteOptions)
  */
 export declare function calculateTransitRoute(options: TransitRouteOptions): Promise<DriveRouteResult>;
 /**
-* 独立路径规划（不会影响当前导航；适合路线预览/行前选路）
-*/
+ * 独立驾车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路、自定义路线选择页
+ * - 后续可配合 selectIndependentRoute / startNaviWithIndependentPath 使用
+ */
 export declare const independentDriveRoute: (options: IndependentDriveRouteOptions) => Promise<IndependentRouteResult>;
 /**
- * 独立货车路径规划（不干扰当前导航）
+ * 独立货车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export declare const independentTruckRoute: (options: IndependentTruckRouteOptions) => Promise<IndependentRouteResult>;
 /**
- * 独立步行路径规划（不干扰当前导航）
+ * 独立步行路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export declare const independentWalkRoute: (options: IndependentWalkRouteOptions) => Promise<IndependentRouteResult>;
 /**
- * 独立骑行路径规划（不干扰当前导航）
+ * 独立骑行路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export declare const independentRideRoute: (options: IndependentRideRouteOptions) => Promise<IndependentRouteResult>;
 /**
- * 独立摩托车路径规划（不干扰当前导航）
+ * 独立摩托车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export declare const independentMotorcycleRoute: (options: IndependentMotorcycleRouteOptions) => Promise<IndependentRouteResult>;
 /**
  * 独立路径组：选主路线
+ *
+ * - 仅切换 token 对应路径组里的当前主路线
+ * - 本身不会开始导航
  */
 export declare const selectIndependentRoute: (options: SelectIndependentRouteOptions) => Promise<boolean>;
 /**
  * 独立路径组：使用指定路线启动导航
+ *
+ * - 这是模块级启动入口，不依赖 ExpoGaodeMapNaviView ref
+ * - 适合工具函数、流程封装、非嵌入式页面场景
+ * - 若你已经持有嵌入式导航视图 ref，更适合调用 ref.startNavigationWithIndependentPath(...)
  */
 export declare const startNaviWithIndependentPath: (options: StartNaviWithIndependentPathOptions) => Promise<boolean>;
 /**
@@ -80,6 +103,9 @@ export declare const startNaviWithIndependentPath: (options: StartNaviWithIndepe
 export declare const openOfficialNaviPage: (options: OfficialNaviPageOptions) => Promise<boolean>;
 /**
  * 独立路径组：清理
+ *
+ * - 释放 independentXXXRoute 生成的 token 对应缓存
+ * - 当页面只保留路线预览、不再需要后续选路/导航时，建议主动清理
  */
 export declare const clearIndependentRoute: (options: ClearIndependentRouteOptions) => Promise<boolean>;
 export type { NaviPoint, RouteOptions, DriveRouteOptions, WalkRouteOptions, RideRouteOptions, EBikeRouteOptions, TransitRouteOptionsType as TransitRouteOptions, TruckRouteOptions, RouteResult, DriveRouteResult, IndependentRouteResult, IndependentDriveRouteOptions, IndependentTruckRouteOptions, IndependentWalkRouteOptions, IndependentRideRouteOptions, SelectIndependentRouteOptions, StartNaviWithIndependentPathOptions, OfficialNaviPageOptions, ClearIndependentRouteOptions, MotorcycleRouteOptions, IndependentMotorcycleRouteOptions, BuildAnchorWaypointsOptions, FollowWebPlannedRouteOptions, FollowWebPlannedRouteResult, FollowWebPlannedRouteCandidate, WebPlannedRoute, NaviInfoUpdateEvent, NaviLaneInfoEvent, NaviTrafficStatusesEvent, NaviVisualStateEvent, ExpoGaodeMapNaviViewProps, };

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -552,31 +552,54 @@ export async function calculateTransitRoute(options) {
     return normalizeTransitRouteResult(options, result);
 }
 /**
-* 独立路径规划（不会影响当前导航；适合路线预览/行前选路）
-*/
+ * 独立驾车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路、自定义路线选择页
+ * - 后续可配合 selectIndependentRoute / startNaviWithIndependentPath 使用
+ */
 export const independentDriveRoute = (options) => ExpoGaodeMapNavigationModule.independentDriveRoute(options);
 /**
- * 独立货车路径规划（不干扰当前导航）
+ * 独立货车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export const independentTruckRoute = (options) => ExpoGaodeMapNavigationModule.independentTruckRoute(options);
 /**
- * 独立步行路径规划（不干扰当前导航）
+ * 独立步行路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export const independentWalkRoute = (options) => ExpoGaodeMapNavigationModule.independentWalkRoute(options);
 /**
- * 独立骑行路径规划（不干扰当前导航）
+ * 独立骑行路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export const independentRideRoute = (options) => ExpoGaodeMapNavigationModule.independentRideRoute(options);
 /**
- * 独立摩托车路径规划（不干扰当前导航）
+ * 独立摩托车路径规划
+ *
+ * - 只负责生成独立路径组，不会自动开始导航
+ * - 适合路线预览、行前选路
  */
 export const independentMotorcycleRoute = (options) => ExpoGaodeMapNavigationModule.independentMotorcycleRoute(options);
 /**
  * 独立路径组：选主路线
+ *
+ * - 仅切换 token 对应路径组里的当前主路线
+ * - 本身不会开始导航
  */
 export const selectIndependentRoute = (options) => ExpoGaodeMapNavigationModule.selectIndependentRoute(options);
 /**
  * 独立路径组：使用指定路线启动导航
+ *
+ * - 这是模块级启动入口，不依赖 ExpoGaodeMapNaviView ref
+ * - 适合工具函数、流程封装、非嵌入式页面场景
+ * - 若你已经持有嵌入式导航视图 ref，更适合调用 ref.startNavigationWithIndependentPath(...)
  */
 export const startNaviWithIndependentPath = (options) => ExpoGaodeMapNavigationModule.startNaviWithIndependentPath(options);
 /**
@@ -585,6 +608,9 @@ export const startNaviWithIndependentPath = (options) => ExpoGaodeMapNavigationM
 export const openOfficialNaviPage = (options) => ExpoGaodeMapNavigationModule.openOfficialNaviPage(options);
 /**
  * 独立路径组：清理
+ *
+ * - 释放 independentXXXRoute 生成的 token 对应缓存
+ * - 当页面只保留路线预览、不再需要后续选路/导航时，建议主动清理
  */
 export const clearIndependentRoute = (options) => ExpoGaodeMapNavigationModule.clearIndependentRoute(options);
 export { RouteType, DriveStrategy, WalkStrategy, RideStrategy, TruckSize, TravelStrategy, };