如何使用SDK开发站点

SDK目录结构
如果您是通过网盘下载SDK的zip包，需要自行安装JRE并且解压。SDK的基本目录结构：
bin目录：管理工具启动脚本程序。Windows *** 作系统，启动NewStartServerbat或者StartServerbat。非Windows *** 作系统，启动startServersh。特别提醒，确保 *** 作系统中使用最新的JRE 6以上版本
conf目录：SDK服务器的配置文件，请不要随意修改
db目录：存放SDK本地数据库文件，请不要随意修改
lib目录：SDK服务器依赖的类库文件，请不要随意修改
sdk_open_apiphp文件：SDK支持的开放API接口，属于数据开放接口，TAE应用也可以使用
tae_open_apiphp文件：TAE支持的开放API接口，为TAE提供基础服务，作为sdk_open_apiphp的补充
topclientphp文件：淘宝开放平台（TOP）的服务调用接口
启动SDK工具
根据具体 *** 作系统，启动bin目录中的启动脚本。本例中使用的Windows *** 作系统运行的结果：
SDK将会自动启动用户偏好的浏览器：
注意：服务器端口，与后面的访问的时候的端口保持一致。
当前SDK工具没有提供TAE APP的应用管理页面，而是需要开发者手动绑定开发。接下来具体介绍如何开发TAE应用。
成功启动后，目录结构会发生变化：
不难发现，apps目录被自动创建了，该目录就是管理TAE 应用的目录。
目录结构及配置
首先，使用投票应用voteapp为例，其目录结构如下图：
从上图中，可以初步了解一个应用APP的目录基本结构，接下来，详细详细介绍各个目录的作用以及规范。
静态资源目录：assets目录，包括js、css和文件。文件均存放在imagse子目录中，页面渲染样式CSS文件都存放在stylesheets目录中，而Javascripts目录则是管理JavaScript脚本文件。后面的章节会具体介绍如何访问这些资源文件。
数据库访问目录：dao目录的文件复制数据库访问和sql的封装。例如上图中dbconfigphp则利用PHP的PDO技术，管理配置数据库数据源，即PDO对象。其他的vote_xxx_daophp则是数据库访问对象（DAO）的封装。
应用服务目录：service目录管理封装了相关的应用相关的核心业务逻辑PHP页面。所谓的服务，就是为视图页面提供服务调用的接口，实现业务逻辑，减少代码耦合度。
视图文件目录：view目录是web层，负责页面的布局、内容的展现和请求跳转控制,tae web层的使用smarty模板引擎， tae自己实现了url的控制和映射，具体使用见配置文件。
appyml是应用的配置文件，demo中具体的目录可以通过配置文件统一配置，具体配置项见下文。
根目录下appyaml文件定义了该应用的具体组成部分， 具体介绍如下：
!!comtaobaotaeconfigdomainConfig
#应用元信息
title: voteapp
description: 投票应用新的结构
version: 10
language: php
author: shihong
thumbnail: /aaajpg
#type: 1 tae 模块 2 独立站点
type: 2
#全局css的配置
css: /assets/stylesheets/gcss
#首页 通过域名直接访问的页面如testuztaobaocom访问时的页面
index: /view/front/viewphp
#>用sdk开发的软件不可以在内网部署。可将模型部署在私有CPU/GPU服务器上，，支持API和SDK两种集成方式。可在内网/或无网环境下使用模型，确保数据隐私。sdk意思是软件开发工具包，一般是一些软件工程师为特定的软件、软件框架、硬件平台、 *** 作系统等建立应用软件时的开发工具的集合。软件开发工具包括广义上指辅助开发某一类软件的相关文档、范例和工具的集合。

1、先到google开发网站下载合适的SDK和ADT，网址：developer/sdk/indexhtml该网站已经被和协了，到百度里搜一下>SDK是技术人员写进POS机的程序，POS机要绑定商户信息才可以使用。你说的这个情况，有可能是SDK程序出现了问题，也有可能这个POS机已经绑定了其他商户。给最初绑定的商户信息不符。

米讯SDK，主要提供各种即时通讯服务。帮助游戏和app快速实现 实时聊天，私信留言，音视频通话，群聊等im功能。

目前我们提供了Android、iOS的客户端SDK，同时提供了各个平台的详细文档和Demo，帮助快速入门。

 我们强烈建议你阅读完本篇指南之后，再去查看以上的详细文档。

接入方需要通过唯一的appid、appkey、guid来向米讯服务器绑定用户，后续交互通过这个guid来标志一个用户。

米讯服务器不关心guid的业务逻辑，接入方只需要保证guid独立性。

米讯服务器提供open-api，接入方服务器需要随时和米讯服务器同步群组关系。

支持 room（聊天室）和group（群组）两种群聊模式。

room：只提供在线消息收发，用户离线时自动退出。不保存记录。（频道聊天，房间聊天等）

group：稳定的群组关系，提供云端消息存储和离线消息等功能。（工会聊天、邮件等）

支持单聊、聊天室、群聊。并且具备完善的群组管理功能。

支持文字、语音、自定义文件、小视频、（开发中）等多种自定义类型消息。

聊天记录保存在云端，允许自由获取。

支持系统向指定用户和群组发送消息。

提供最多16人的 多人实时语音通话功能

支持通话中的各种设定

支持根据带宽情况，只能调整流量消耗

支持最多4人的多人视频功能（开发中）

如果不需要使用实时通话功能：可以删掉lib中的 rtc-sdk-jniso 和 libHDACEngineso 文件以减小SDK体积。

离线消息推送

敏感词过滤

资料和关系链托管

其他个性化业务

如有需求请单独联系我们

原生的 Android、iOS、的客户端 SDK

服务器帐号绑定、群组管理、系统消息发送的open api

可以实时监控用户数、消息数的开发者控制台（开发中）

为方便unity游戏接入，我们提供了unity的SDK封装和样例工程。

unityDemo分为展示基础功能的appDemo和演示游戏中实时通话的SpaceShooter。接入方可以按需参考。

接入方从米讯获取 appID和appkey。

所有服务端的接口鉴权，都要通过appID和appkey来实现。请妥善保存。

客户端接口需要的token、publicID、publickey，需要由接入方服务器，用appID和appkey来换取。再转发给客户端保存。

2、账户绑定（guid、token、pubkey）

接入方需要提供唯一的id来标识一个用户端。这个id，在米讯SDK中，称之为guid（最长128个字符）。

接入方服务器需要调用米讯服务器的bind_account（appid，appkey，guid）来进行注册。米讯服务器将返回对应这个guid的 token、publicID、publickey。

接入方app，在初始化米讯SDK提供的服务时，需要提供 （guid，token，publicID，publickey）。

 米讯服务器不关心guid的业务逻辑，接入方只需要保证guid独立性。

3、群聊（room，group）

米讯SDK提供两种模式的消息群聊服务。分别适合不同的场景。

所有群组的管理，需要接入方服务器和米讯服务器实时交互，保证用户在正确的群里。

接入方app，调用米讯sdk消息 *** 作，负责向群里的用户收发消息。SDK暂时不提供群组管理功能。

聊天室（Room）

只提供在线消息收发，用户离线（超过5min没心跳）自动退出room。再次上线需要重新加入。不保存消息记录。

适合频道聊天、聊天室、随机配对聊天等场景。

一个room，最多同时在线10000人。

rid：接入方定义，要保证不同room的rid唯一性。（128个字符内）

roomtype：接入方定义，方便用户屏蔽某一类room的消息。

群组（Group）

稳定的群组关系，提供云端消息存储和离线消息等功能。需要接入方服务器控制成员进出和群组创建销毁。

适合工会聊天，固定群聊等。

一个group，最多有1000个成员。

gid：接入方定义，要保证不同group的gid唯一性。（128个字符内）

grouptype由业务方定义，方便用户屏蔽某一类group的消息。

4、消息（Message）

Message是SDK用来传输消息的基本对象。需要接入放app构造，然后调用sdk的send接口进行发送。

Message的关键信息如下：

属性类型说明

messageID

String发送方填写的消息ID，用于本地消息去重

fromString发送方ID

targetString接收方ID ,单聊时为对方guid，群聊时为roomID或groopID

bodyMessageBody消息体。不同类型的消息，消息体内容不同，详见下方说明

bodyTypeint消息体枚举类型。暂时包括文本、语音。决定如何解释消息。

messageSeqlong服务端分配的消息序号，用于消息同步，离线消息拉取等



MessageBody

我们提供一下几种类型的MessageBody，后续会持续扩展

0、CustomMessageBody：data

1、TextMessageBody：text

2、AudioMessageBody：audioFilePath；audioUrl；duration

请接入方注意，控制每个Message最大不超过 5KB 的数据。

关于语音消息的录制工具，和自定义消息的方法，请参考详细说明文档。

4、语音通话（VOIP）和会议（Conference）

1、使用语音通话时，接入方服务器，需要先和米讯服务器交互，创建conference。并维护Conference里面的成员。

2、接入方客户端，通过joinconf（confid，guid）来加入确定的conference（前提是，这个conference的成员里面有这个人）

3、客户端加入房间成功后，可以使用各种接口控制音频通话 和 实时获取成员状态。

4、离开conference和确定conference不再使用时，需要及时leave和destroy。

如果不需要使用实时通话功能：可以删掉lib中的 rtc-sdk-jniso 和 libHDACEngineso 文件以减小SDK体积。

五、调用流程概要

1、发消息

2、实时语音通话

交互示意

调用流程图

六、详细文档和Demo

Android SDK 详情

iOS SDK 详情

服务端的 OpenAPI

七、****

业务对接和常见问题：

韩尚佑；QQ：271843826；e-mail：hanshangyou@xiaomicom

服务端API：

张友明；QQ：179818827；e-mail：zhangyouming@xiaomicom

Android-SDK：

连冬阳；QQ：2460572865；e-mail：liandongyang@xiaomicom

刘飞；QQ：276985107；e-mail：liufei3@xiaomicom

iOS-SDK：

柯洪峰；QQ：249082954；e-mail：kehongfeng@xiaomicom

---