前端相关

1294字约4分钟

2024-10-15

以下描述中的目录均是在部署机器的\mars3d-studio\下的相对路径。

问题：访问后端服务地址有误

修改/html/config/url.js，按注释说明按需调整domain值，实际部署用默认即可。

// 配置地址
const domain = window.location.host; // 默认用这个

// 下面是开发中测试用的
// let domain = '192.168.0.196'; // 本地测试服务器
// let domain = '127.0.0.1'; //本机测试服务

url.js 中文件是整个项目的核心路径配置文件，涵盖了主项目、map 项目以及看板项目的路径设置。该文件定义了以下关键路径：

domain：服务器地址。
window.studio_url.api：后端 API 接口地址。
window.studio_url.ws：WebSocket 服务地址，支持实时通信功能。
window.studio_url.studio_data：用于存储上传的图层数据或其他资源文件的地址。
window.studio_url.mars3d_data：内置演示数据的存储地址。

以上路径名称不可修改，实际值非必要请勿修改，主要只改下后端服务的IP地址和端口即可，确保项目正常运行。

问题：平台静态资源需要在外部系统直接访问，无需token鉴权如何修改？

增加nginx配置代理静态资源目录代码编辑工具(请勿用记事本)打开D:\mars3d-studio\deps\nginx\conf\host\m80.conf文件，增加location /studio-data/配置, 关键配置如下：

conf\host\m80.conf

 location / {
    root   D:/mars3d-studio/html; #【关键】根据实际安装路径进行调整
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
 }
 location ^~/api/ {
  # 已忽略其他配置
 }

 # 静态资源
 location /studio-data/ {
    include nginx_cors;  #允许跨域配置
    root D:/mars3d-studio/data;  #【关键】根据实际安装路径进行调整
    expires 7d;
 }

其中root D:/mars3d-studio/data配置，需要根据实际部署路径进行修改后保存。

如果是复用自己的 nginx 服务，将当前关键配置拷贝进去后独立端口访问即可，其中的include nginx_cors配置需要拷贝部署包中的D:/mars3d-studio/deps/nginx/conf/nginx_cors文件到自己 nginx 安装目录的 conf 子目录下。

修改前端代码studio_data配置项值

打开/html/config/url.js文件，修改其中studio_data值：

// 已忽略其他代码
window.studio_url = {
  // 已忽略其他配置
  studio_data: `${prefix}/studio-data`, // studio上传数据，比如：有鉴权 http://192.168.0.196/api/files 或 无鉴权 http://192.168.0.196/studio-data (需要nginx配置) 
};

问题：如果有购买mars3d-data离线数据，如何修改使用本地演示数据

可以将购买的Mars3D示例离线数据放在安装目录的/mars3d-studio/data/mars3d-data/目录下，

增加nginx配置代理静态资源目录代码编辑工具(请勿用记事本)打开D:\mars3d-studio\deps\nginx\conf\host\m80.conf文件，增加location /studio-data/配置, 关键配置如下：

conf\host\m80.conf

 location / {
    root   D:/mars3d-studio/html; #【关键】根据实际安装路径进行调整
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
 }
 location ^~/api/ {
  # 已忽略其他配置
 }

 # mars3d离线数据
 location /mars3d-data/ {
    include nginx_cors;  #允许跨域配置
    root D:/mars3d-studio/data;  #【关键】根据实际安装路径进行调整
    expires 7d;
 }

其中root D:/mars3d-studio/data配置，需要根据实际部署路径进行修改后保存。

如果是复用自己的 nginx 服务，将当前关键配置拷贝进去后独立端口访问即可，其中的include nginx_cors配置需要拷贝部署包中的D:/mars3d-studio/deps/nginx/conf/nginx_cors文件到自己 nginx 安装目录的 conf 子目录下。

修改前端代码mars3d_data配置项值

打开/html/config/url.js文件，修改其中mars3d_data值：

// 已忽略其他代码
window.studio_url = {
  // 已忽略其他配置
  mars3d_data: `${prefix}/mars3d-data`, // mars3d演示数据，比如：在线 https://data.mars3d.cn  或 离线 http://192.168.0.196/mars3d-data
};

问题：修改默认场景的底图改为本地离线资源路径如何修改

可以通过vscode工具打开/html/map-project/config/目录，按需修改所有json文件，这些是地图相关的默认配置资源文件，按需修改为本地离线资源。

比如修改默认三维场景的底图和地形为离线服务，可以这样修改。 vscode打开html\project-map\config\config.json、config-2d.json、config-null.json文件,参考config.json文件说明教程进行修改basemaps和terrain配置。

{ 
  //已忽略其他参数
   "terrain": {
    "url": "{mars3d_data}/terrain",
    "show": true
  },
  "basemaps": [
    {
      "id": 10,
      "name": "地图底图",
      "type": "group"
    },
    {
      "pid": 10,
      "name": "影像地图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/gaode_img.png",
      "type": "xyz",
      "url": "{mars3d_data}/tile/img/{z}/{x}/{y}.jpg",
      "chinaCRS": "GCJ02",
      "show":true
    },
    {
      "pid": 10,
      "name": "电子地图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/gaode_vec.png",
      "type": "xyz",
      "url": "{mars3d_data}/tile/vec/{z}/{x}/{y}.png",
      "chinaCRS": "GCJ02"
    },
    {
      "id": 2017,
      "pid": 10,
      "name": "蓝色底图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/my_blue.png",
      "type": "xyz",
      "url": "{mars3d_data}/tile/vec/{z}/{x}/{y}.png",
      "chinaCRS": "GCJ02",
      "invertColor": true,
      "filterColor": "#4e70a6",
      "brightness": 0.6,
      "contrast": 1.8,
      "gamma": 0.3,
      "hue": 1,
      "saturation": 0
    },
    {
      "pid": 10,
      "name": "绿色底图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/my_green.png",
      "type": "xyz",
      "url": "{mars3d_data}/tile/vec/{z}/{x}/{y}.png",
      "chinaCRS": "GCJ02",
      "invertColor": true,
      "filterColor": "rgba(12, 238, 230)",
      "brightness": 1,
      "contrast": 1.0,
      "gamma": 0.2,
      "hue": 1,
      "saturation": 0
    },
    {
      "pid": 10,
      "name": "黑色底图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/my_dark.png",
      "type": "xyz",
      "url": "{mars3d_data}/tile/vec/{z}/{x}/{y}.png",
      "chinaCRS": "GCJ02",
      "invertColor": true,
      "filterColor": "#909090",
      "brightness": 0.6,
      "contrast": 1.8,
      "gamma": 0.3,
      "hue": 1,
      "saturation": 0
    },
    {
      "pid": 10,
      "name": "单张图片",
      "icon": "{mars3d_data}/img/thumbnail/basemap/offline.png",
      "type": "image",
      "url": "{mars3d_data}/img/map/world/world.jpg"
    },
    {
      "id": 1016,
      "pid": 10,
      "name": "无底图",
      "icon": "{mars3d_data}/img/thumbnail/basemap/null.png",
      "type": "grid",
      "color": "#ffffff",
      "alpha": 0.03,
      "cells": 2
    }
  ],
}