3.9 KiB
教程：5分钟上手XCharts
返回首页
XChartsAPI接口
XCharts配置项手册
获取和引入 XCharts
你可以通过以下两种方式获取 XCharts 。
如果你只是想运行 Demo 查看效果，可以在 Github上的 Clone or download下载最新版本或去 release下载稳定版本，将源码工程解压后用unity打开即可。
如果你要将 XCharts 加入你的项目中，可以在Github上下载最新的 release稳定版本，将 XCharts-vx.x.x.unitypackage 通过 Unity 导入到你的项目中，或下载 Source code 解压后将内部的 XCharts 文件夹拷贝到你项目的 Assets 目录下。
如果你是Unity 2018.3版本以上，强烈建议通过Package Manager来安装XCharts包，具体操作步骤如下：
- 打开
Packages目录下的manifest.json文件，在dependencies下加入："com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#package", - 回到
Unity，可能会花3到5分钟进行下载和编译，成功后就可以开始使用XCharts了。 - 如果要删除
XCharts，删除掉1步骤所加的内容即可。 - 如果要更新
XCharts，删除manifest.json文件的lock下的com.monitor1394.xcharts相关内容即会重新下载编译。在Component -> XCharts -> Check For Update可以检测是否有新版本可更新。
添加一个简单图表
新建场景或在已有场景的 Canvas 下添加一个名为 line_chart 的 GameObject。
选中 line_chart，通过菜单栏 Component->XCharts->LineChart 或者 Inspector 视图的 Add Component 添加 LineChart 脚本。设置 line_chart 的尺寸，一个简单的折线图就出来了。
在 Inspector 视图下可以调整各个组件的参数，Game 视图会实时反馈调整的效果。各个组件的详细参数说明可查阅XCharts配置项手册。
用代码添加折线图
给gameObject挂上LineChart脚本：
var chart = gameObject.GetComponent<LineChart>();
if (chart == null)
{
chart = gameObject.AddComponent<LineChart>();
}
设置标题：
chart.title.show = true;
chart.title.text = "Line Simple";
设置提示框和图例是否显示：
chart.tooltip.show = true;
chart.legend.show = false;
设置是否使用双坐标轴和坐标轴类型：
chart.xAxises[0].show = true;
chart.xAxises[1].show = false;
chart.yAxises[0].show = true;
chart.yAxises[1].show = false;
chart.xAxises[0].type = Axis.AxisType.Category;
chart.yAxises[0].type = Axis.AxisType.Value;
设置坐标轴分割线：
chart.xAxises[0].splitNumber = 10;
chart.xAxises[0].boundaryGap = true;
清空数据，添加Line类型的Serie用于接收数据：
chart.RemoveData();
chart.AddSerie(SerieType.Line);
添加10个数据：
for (int i = 0; i < 10; i++)
{
chart.AddXAxisData("x" + i);
chart.AddData(0, Random.Range(10, 20));
}
这样一个简单的折线图就出来了：
完整代码请查阅Demo：Demo10_LineSimple.cs
你还可以用代码控制更多的参数，XCharts配置项手册里面的所有参数都是可以通过代码控制的。