注册接入类问题

- 如何注册百度安全OTA的账号？

• 答：百度安全OTA使用百度全线产品通用的账号体系，如果您已有百度账号可以直接登录，如果没有百度账号，可前往passport.baidu.com进行注册

- 如何更改账号密码？忘记密码怎么办？如何更改账号绑定的手机号和邮箱？

• 答：需要找回密码或更改密码，或是更改账号绑定的手机号和邮箱，均可前往passport.baidu.com进行操作。

- 百度安全OTA平台是否支持注册企业账号？

• 答：百度安全OTA平台使用百度权限产品通用的账号体系，没有企业账号的概念。若业务发生人员变动导致需要变更管理员，可使用平台中的“权限管理”功能。

- 如何获取各个系统的SDK文件及使用文档？

• 答：进入ota.baidu.com/platform/sdk，选择适用的系统SDK下载及对应使用指南（RTOS等嵌入式设备也选择Linux系统的SDK）。

- 如何在设备中集成SDK？

• 答：具体的SDK方法请阅读ota.baidu.com/platform/sdk中提供下载的使用指南。

- 如何接入试用百度安全OTA服务？

• 答：使用百度账号登录百度安全OTA服务平台（ota.baidu.com)，点击“新增产品线“后如实填写企业及设备信息后提交，保持手机通畅，我们将尽快进行信息审核，完成审核后即获取试用权限，根据系统类型的不同将对应的SDK集成至设备中即完成接入。

- 百度安全OTA现在支持什么类型的系统？

• 答：百度安全OTA目前支持主流的物联网设备操作系统，包括Android、Linux、Windows、RTOS以及多个嵌入式系统。

- 试用和正式使用相比有什么服务限制吗？

• 答：试用权限的产品线拥有30台激活设备和50G流量的额度组合，足够厂商进行全面的调试工作；确认正式接入后，激活设备和流量额度将按照合同规定或实际购买套餐进行授予。

- 试用后感觉满意，如何正式接入？

• 答：如有正式接入意向，可直接与百度OTA平台的商务人员进行沟通，或者点击任务列表中的“点击获取更多设备数与流量配额”按钮申请转正。

- 哪里可以查看我的产品线ID和密钥？

• 答：申请的产品线经过审核后会展示在产品线列表中，点击产品线进入到任务列表，点击左侧的“产品线信息”可查看产品线ID和密钥，用以集成SDK。

创建任务类问题

- 如何下发升级任务？

• 答：点击进入已审批的产品线，点击左上角的“创建任务”按钮进入任务配置页面， 填写任务名称，上传升级资源文件，并按照实际需求配置升级条件，然后点击“创建任务”即可。任务创建完成后会进入测试阶段，测试阶段仅会对测试设备列表中的设备进行任务下发，用户可以实时动态对测试设备列表进行增删操作，若用户对测试阶段的升级结果感到满意，即可通过测试进入正式下发阶段对外部设备进行下发。

- 任务创建之后是立即生效吗？是否可以指定任务生效时间？

• 答：任务创建后会立即进入测试阶段并对测试设备生效，需要用户手动确认并进入正式阶段才会对外部设备生效。 创建任务时可以设置升级任务延时生效或固定时段升级： 任务生效时间：在高级配置-升级时间配置-任务生效时间中选择延时生效，输入日期及时间，设置后的任务在通过测试后会挂起，到达指定时间点后开始对外部设备下发。 固定时段升级：在高级配置-升级时间配置-固定时段升级中输入起始时间和结束时间，设备只会在该时间区间请求到升级任务。

- 如何上传升级资源？

• 答：有以下两种方式上传升级资源：1.在创建任务时，直接上传升级资源文件；2.进入产品线后，点击侧边栏的“升级资源库”，选择差分包或整包文件库并点击“本地上传”，上传的文件将在云端保存，可在创建任务时直接选取。

- 测试阶段和正式下发阶段有什么区别？

• 答：从升级范围而言，测试阶段的升级设备范围仅限于测试设备，用户可在测试设备管理页面中通过设备ID绑定100台以内的测试设备，测试阶段仅对基础配置以及高级配置中的固定时段升级、流量保护和电量要求配置生效，其余配置不生效；正式下发阶段理论上可对所有存量设备下发升级任务，实际生效情况视任务条件而定。 从升级目的而言，测试阶段主要用于对下发通道和升级包可用性的检验，以防有问题的升级包流向正式环境；正式下发阶段主要实现真实的升级需求。

- 同时配置多个升级任务，设备会请求到哪一个？

• 答：若一台设备同时符合多个升级任务的下发条件，首先会按照优先级从高到低排序（优先级在配置任务或下发过程中可配置）依次生效，若优先级相同则对比目标版本，优先生效高版本任务，若目标版本仍相同，则随机命中。

- 创建任务后还可以更改任务优先级吗？

• 答：可以，任务生效后可在任务概览-优先级中实时修改任务优先级。

- 差分任务的好处是什么？如何获取差分包？

• 答：当升级内容较少时，使用差分升级可减少下载资源造成的流量，缩短升级时间。安卓用户可在在OTA平台中的“差分包管理”页面中上传原料target包进行在线差分包制作，Linux用户可利用SDK压缩包内的工具在本地进行差分包制作。

- 如何利用平台功能进行灰度升级？

• 答：用户在完成所有任务配置信息后，进入“测试验证”页面。在页面“任务概况”栏最右侧中找到“灰度下发配置”即可对当前任务做灰度升级配置。平台提供最多不超过五次灰度升级功能。用户可以根据需求选择设备数灰度下发升级任务或比例灰度下发升级任务。

- 任务下发后可以更改指定的设备范围吗？

• 答：任务下发后可在正式下发阶段对指定的设备范围进行增删修改。

- 可以分渠道进行设备升级吗？

• 答：可以，创建任务时在高级配置-升级范围配置-渠道筛选中填入渠道号，即可对待有指定渠道号的设备进行升级任务下发。

- 可以仅对设备中的app进行升级吗？

• 答：可以，对于安卓设备，可以在创建任务时选择任务类型为应用升级，输入对应的应用包名，上传应用升级包即可。

- 可以对特定版本的设备进行升级吗？

• 答：可以，创建任务时在高级配置-升级范围配置-升级条件中选择条件筛选，在版本限定中输入版本号或版本号区间，任务仅对版本号为该范围的设备进行任务下发。

- 可以对指定地区的设备进行升级吗？

• 答：可以，创建任务时在高级配置-升级范围配置-升级条件中选择条件筛选，在地域限定中选择行政区域（可精确到地级市），任务仅对指定地区的设备进行任务下发。

任务追踪类问题

- 设备没有请求到升级任务，可能是什么原因？

• 答：造成设备没有请求到升级任务的原因有很多，在确认设备通电、已打开开关且正常联网的前提下，请按照以下方法自查： 1.任务是否处于“正式下发”阶段？ 在平台设置的“测试设备”会在测试验证阶请求到升级任务，其余设备仅在“正式下发”阶段请求到升级任务，若任务处于测试验证阶段，请手动完成测试 2.任务是否配置了延时生效或固定时段升级？ 延时生效任务，进入正式下发阶段后将暂时挂起，直到配置的延时生效时间后下发。固定时段在测试验证阶段和正式下发阶段均生效。 3.创建任务时填写的版本号是否比设备版本号更小？ 设备请求升级时会对比设备版本号与任务版本号的大小，当设备版本号＜任务版本号时才会响应请求。四位版本号从左到右依次对比，如1.2.3.4＜1.2.3.11 4.创建定向下发任务，上传的txt中多个设备id是否有用换行去分隔？ 上传的设备id列表txt需要以换行分隔多个id，每行一个，不需要其他分隔符 5.激活设备和流量额度是否达到上限？ 查看设备列表页的右上角，活跃设备数与已用流量是否达到上限 6.是否有其他优先级更高的任务同时命中？ 查看该产品线是否有其他任务同时正在下发中，如果有，确认这些任务的优先级是否更高。 7.未接收到任务的时间间隔是否达到30分钟？ 每台设备的固定请求时间间隔默认为30分钟，30分钟内可以请求到任务即为正常 8.是否设置了定量目标： 设置定量目标后，当下发任务的设备数达到了定量目标，后台会停止下发，其余设备将无法请求到该任务。

- 已经创建的任务可以在哪里查看？

• 答：点击产品线后会进入任务列表，可通过任务状态筛选查看不同状态的任务，已删除的任务可以任务回收站查看。

- 测试阶段的任务如何进入到正式下发阶段？

• 答：在测试阶段的任务中点击“终止/完成测试”，选择“测试符合预期，进入升级流程”即可进入正式下发阶段，若选择测试终止，则会关闭该任务。

- 升级数据中各项数据分别代表什么含义？

• 答：各项数据含义如下： 激活设备数：集成了SDK并写入该产品线ID，且有过开机联网历史的设备数量，是理论上可以升级的最大设备集合 计划升级数：本次任务计划升级的目标数，根据任务类型不同有所区别 请求设备数：请求到本次任务的设备数 升级成功数：升级成功并上报升级结果的设备数 升级失败数：进入到升级环节并上报失败的设备数 升级成功率：升级成功率= 升级成功数/请求设备数

- 升级任务的各项数据是否实时展示？

• 答：升级数据中的各项数据以及升级状态为实时展示数据，升级详情中的分日升级数据将在次日展示。

- 升级任务的各项属性代表什么含义？

• 答：升级类型：包括系统升级和应用升级，每一类升级又可以区分整包升级和差分升级 条件筛选：创建任务时配置，可指定版本号区间或地域区间进行设备范围筛选 渠道筛选：创建任务是配置，可指定渠道号进行下发 定向升级：可指定或屏蔽设备ID，也可以通过模糊匹配指定或屏蔽批量设备 升级状态：设备最新的升级状态，包括请求成功、下载完成、下载失败、开始安装、升级成功、升级失败，每个设备在同一时间点只会存在于一种状态中。注：当设备升级失败后，有可能会重新检查到任务并进入到别的流程中。

- 升级成功率偏低可能是什么原因？

• 答：升级成功率偏低，可能是以下原因造成的： 1.设备是提示升级，需要用户确认才会走升级流程，导致成功升级数偏低 2.网速较差，或升级包较大，设备走完升级流程所费时间较长 3.大量设备在下载环节或安装环节产生错误，需要根据错误原因具体分析，如发现升级失败数较高，可联系百度OTA平台工作人员查询日志追踪问题。

- 如何查看任务中某台设备的升级情况？

• 答：在测试阶段，测试设备列表展示了所有测试设备的升级状态；在正式下发阶段，可在升级状态查询中选择“按设备ID查询”，输入设备ID可查看该设备最新的升级状态。

- 如何查看任务中所有设备的升级情况？

• 答：在正式下发阶段，可在升级状态查询中选择“按升级状态查询”，并选择“全部请求升级设备”，可以查看所有请求过该任务的设备的升级状态。

数据统计类问题

- 如何查看产品线中设备的版本分布？

• 答：在侧边栏点击“数据分析”，点击希望查看的日期，可以看到该日活跃设备中的版本分布。

其他问题

- 产品线管理人员发生了变更，如何修改管理员名单？

• 答：管理员（默认为产品线的创建者账号）可进入产品线信息，点击权限管理，通过百度账号添加管理人员并对该账号赋予不同的权限。只读权限只能查看数据，无法进行操作，操作权限可以创建或终止任务，管理员权限除了有操作权限，还可以对权限管理名单进行编辑。

- 有什么途径可以快速复用历史任务吗？

• 答：在任务详情中有“复用任务”按钮，点击可创建一个条件一致的任务。

- 哪里可以查看操作日志？

• 答：控制台页面左下角操作日志可以查看重要操作的时间和操作账号。