差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
f_qudaojieru:d_androidsdk [2016-12-06 11:56] weijia |
f_qudaojieru:d_androidsdk [2017-02-07 15:38] (当前版本) lihuanhuan [使用SDK] |
||
---|---|---|---|
行 1: | 行 1: | ||
====== Android ====== | ====== Android ====== | ||
===== Android SDK下载 ===== | ===== Android SDK下载 ===== | ||
- | 首先[[http://www.rongkecloud.com/download/rkcs/1.0/RKCustomerService-Android.zip|下载]]Android SDK。 | + | 首先[[http://www.rongkecloud.com/download/live/RKLivePlayerSDK_Android.zip|下载]]Android SDK。 |
===== Android SDK目录结构说明 ====== | ===== Android SDK目录结构说明 ====== | ||
- | 在上述地址下载Android SDK文件为RKCustomerService-Android.zip,解压此压缩包,如下图:\\ | + | 在上述地址下载Android SDK文件为RKLivePlayerSDK_Android.zip,解压此压缩包,如下图:\\ |
{{:f_qudaojieru:android_sdk目录结构说明.png}}\\ | {{:f_qudaojieru:android_sdk目录结构说明.png}}\\ | ||
- | *RKCustomerServiceSDK(Android-v1.1.4.19)-20160520.zip | + | *RongkecloudLivePlayer |
为Android SDK library。 | 为Android SDK library。 | ||
- | *RKCustomerServiceSDKDemo(Android-v1.1.4.19)-20160520.zip文件 | + | *RongkecloudLivePlayerDemo |
为Android SDK Demo源码。 | 为Android SDK Demo源码。 | ||
- | *融智客服客户端Android SDK集成使用说明V1.4-160516.docx文件 | ||
- | 为Android SDK集成文档说明。 | ||
===== Android SDK集成方法 ===== | ===== Android SDK集成方法 ===== | ||
- | 创建好您的工程后,将RKCustomerServiceSDK(Android-v1.1.4.19)-20160520.zip解压后倒入到您的工程目录下。 | + | 创建好您的工程后,将RongkecloudLivePlayer倒入到您的工程目录下。 |
==== Android Studio集成方法 ==== | ==== Android Studio集成方法 ==== | ||
-点击标题栏Project Structure,如下图:\\ {{asdaoru1.png}}\\ | -点击标题栏Project Structure,如下图:\\ {{asdaoru1.png}}\\ | ||
-点击后进入如下界面:\\ {{asdaoru2.png}}\\ | -点击后进入如下界面:\\ {{asdaoru2.png}}\\ | ||
-点击Modules,随后点击右侧左上方的“+”,在弹出栏中点击Import Modules,如下图:\\ {{asdaoru3.png}}\\ | -点击Modules,随后点击右侧左上方的“+”,在弹出栏中点击Import Modules,如下图:\\ {{asdaoru3.png}}\\ | ||
- | -弹出选择项目界面,在此选择您的RKCustomerService所在目录,点击右下角OK,即可将此library导入到您的项目中;\\ {{asdaoru4.png}}\\ | + | -弹出选择项目界面,在此选择您的RongkecloudLivePlayer所在目录,点击右下角OK,即可将此library导入到您的项目中;\\ {{asdaoru4.png}}\\ |
-将此library与您的项目连接起来:\\ 同样在Modules项,点击中间项您的app名称,再点击右侧“+”,选择第三项“Modules Dependency”,以myapp为例,如下图:\\ {{asdaoru5.png}}\\ | -将此library与您的项目连接起来:\\ 同样在Modules项,点击中间项您的app名称,再点击右侧“+”,选择第三项“Modules Dependency”,以myapp为例,如下图:\\ {{asdaoru5.png}}\\ | ||
- | -点击Modules Dependency后,弹出选择Modules界面,选择RKCustomerService,如下图:\\ {{asdaoru6.png}}\\ | + | -点击Modules Dependency后,弹出选择Modules界面,选择RongkecloudLivePlayer,如下图:\\ {{asdaoru6.png}}\\ |
- | -选择后RKCustomerService将显示在您的app下,选中RKCustomerService,点击右下角OK即可配置成功,如下图:\\ {{asdaoru7.png}}\\ | + | -选择后RongkecloudLivePlayer将显示在您的app下,选中RongkecloudLivePlayer,点击右下角OK即可配置成功,如下图:\\ {{asdaoru7.png}}\\ |
==== Eclipse集成方法 ==== | ==== Eclipse集成方法 ==== | ||
-将library导入到您的eclipse中,点击左上角File->Import,弹出选择项目界面,如下图:\\ {{edaoru1.png}}\\ | -将library导入到您的eclipse中,点击左上角File->Import,弹出选择项目界面,如下图:\\ {{edaoru1.png}}\\ | ||
- | -选择Android->Existing Android Code Info Workspace,点击“Next”按钮,弹出项目选择界面,点击“Browse”,选择RKCustomerService,加入到您的eclupse中,点击Next,如下图:\\ {{edaoru2.png}}\\ | + | -选择Android->Existing Android Code Info Workspace,点击“Next”按钮,弹出项目选择界面,点击“Browse”,选择RongkecloudLivePlayer,加入到您的eclupse中,点击Next,如下图:\\ {{edaoru2.png}}\\ |
- | -导入成功后,右键RKCustomerService,点击Properties,弹出如下对话框:\\ {{edaoru3.png}}\\ | + | -导入成功后,右键RongkecloudLivePlayer,点击Properties,弹出如下对话框:\\ {{edaoru3.png}}\\ |
-在此对话框中点击Android,在右侧勾选is library,点击Apply,如下图:\\ {{edaoru4.png}}\\ | -在此对话框中点击Android,在右侧勾选is library,点击Apply,如下图:\\ {{edaoru4.png}}\\ | ||
-点击Java Compiler,选择JDK为1.7,点击OK,如下图:\\ {{edaoru5.png}}\\ | -点击Java Compiler,选择JDK为1.7,点击OK,如下图:\\ {{edaoru5.png}}\\ | ||
-将此library与您的app连接:右键您的项目,Build Path->Configure Build Path,弹出如下界面:\\ {{edaoru6.png}}\\ | -将此library与您的app连接:右键您的项目,Build Path->Configure Build Path,弹出如下界面:\\ {{edaoru6.png}}\\ | ||
- | -点击Java Build Path,在右侧点击Projects->Add,选择RKCustomerService,点击OK,即可配置成功,如下图:\\ {{edaoru7.png}}\\ | + | -点击Java Build Path,在右侧点击Projects->Add,选择RongkecloudLivePlayer,点击OK,即可配置成功,如下图:\\ {{edaoru7.png}}\\ |
+ | |||
+ | ===== 导入库文件 ===== | ||
+ | 将全互动Demo下的lib文件夹完整复制到您的工程目录下,并引用里面的库文件。 | ||
===== SDK配置 ===== | ===== SDK配置 ===== | ||
行 36: | 行 37: | ||
<code xml> | <code xml> | ||
<uses-permission android:name="android.permission.INTERNET"/> | <uses-permission android:name="android.permission.INTERNET"/> | ||
- | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | ||
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | ||
<uses-permission android:name="android.permission.WAKE_LOCK"/> | <uses-permission android:name="android.permission.WAKE_LOCK"/> | ||
- | <uses-permission android:name="android.permission.RECORD_AUDIO"/> | + | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> |
- | <uses-permission android:name="android.permission.VIBRATE"/> | + | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> |
+ | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | ||
</code> | </code> | ||
2.配置Activity到您的AndroidManifest.xml中 | 2.配置Activity到您的AndroidManifest.xml中 | ||
<code xml> | <code xml> | ||
- | <!-- 设置连接service页面--> | + | <activity |
- | <activity | + | android:name="com.rongkecloud.live.ui.RKLiveMainActivity" |
- | android:name="com.rongkecloud.customerservice.ui.RKServiceChatConnectActivity" | + | |
android:screenOrientation="portrait" | android:screenOrientation="portrait" | ||
- | android:theme="@android:style/Theme.Translucent"/> | ||
- | <!-- 设置聊天页面--> | ||
- | <activity | ||
- | android:name="com.rongkecloud.customerservice.ui.RKServiceChatMsgActivity" | ||
android:launchMode="singleTask" | android:launchMode="singleTask" | ||
- | android:screenOrientation="portrait" | + | android:clearTaskOnLaunch="true" |
- | android:theme="@android:style/Theme.NoTitleBar" | + | android:theme="@android:style/Theme.Light.NoTitleBar"/> |
- | android:windowSoftInputMode="adjustResize"/> | + | |
- | <!-- 设置留言给客服页面--> | + | |
<activity | <activity | ||
- | android:name="com.rongkecloud.customerservice.ui.RKServiceChatLeaveMessageActivity" | + | android:name="com.rongkecloud.live.ui.chat.RKLiveChatViewImagesActivity" |
android:screenOrientation="portrait" | android:screenOrientation="portrait" | ||
- | android:theme="@android:style/Theme.NoTitleBar"/> | + | android:theme="@android:style/Theme.Translucent.NoTitleBar"/> |
- | <!-- 设置图片滑动页面--> | + | |
<activity | <activity | ||
- | android:name="com.rongkecloud.customerservice.ui.RKServiceChatViewImagesActivity" | + | android:name="com.rongkecloud.live.ui.chat.RKLiveChatSelectFileActivity" |
android:screenOrientation="portrait" | android:screenOrientation="portrait" | ||
- | android:theme="@android:style/Theme.NoTitleBar"/> | + | android:theme="@android:style/Theme.Translucent.NoTitleBar"/> |
</code> | </code> | ||
3.配置receive到您的AndroidManifest.xml中 | 3.配置receive到您的AndroidManifest.xml中 | ||
<code xml> | <code xml> | ||
- | <receiver | + | <receiver |
- | android:name="com.rongkecloud.android.lps.RKServiceBroadcastReceiver" | + | android:name="com.rongkecloud.android.lps.RKPushBroadcastReceiver" |
android:enabled="true" | android:enabled="true" | ||
- | android:exported="false" > | + | android:exported="false"> |
- | <intent-filter | + | <intent-filter android:priority="90000"> |
- | android:priority="90000" > | + | <action android:name="android.intent.action.USER_PRESENT"/> |
- | <action android:name="android.intent.action.USER_PRESENT" /> | + | |
</intent-filter> | </intent-filter> | ||
<intent-filter> | <intent-filter> | ||
- | <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> | + | <action android:name="android.net.conn.CONNECTIVITY_CHANGE"/> |
- | <action android:name="android.net.wifi.RSSI_CHANGED" /> | + | <action android:name="android.net.wifi.RSSI_CHANGED"/> |
- | <action android:name="android.net.wifi.STATE_CHANGE" /> | + | <action android:name="android.net.wifi.STATE_CHANGE"/> |
- | <action android:name="android.net.wifi.WIFI_STATE_CHANGED" /> | + | <action android:name="android.net.wifi.WIFI_STATE_CHANGED"/> |
</intent-filter> | </intent-filter> | ||
<intent-filter> | <intent-filter> | ||
- | <action android:name="lps.message.receive" /> | + | <action android:name="lps.reconnect"/> |
- | <action android:name="action_reconnect" /> | + | <action android:name="lps.ping"/> |
- | <action android:name="action_ping" /> | + | <data android:mimeType="*/*"/> |
- | <data android:mimeType="*/*" /> | + | |
</intent-filter> | </intent-filter> | ||
</receiver> | </receiver> | ||
行 93: | 行 86: | ||
4.配置service到您的AndroidManifest.xml中 | 4.配置service到您的AndroidManifest.xml中 | ||
<code xml> | <code xml> | ||
- | <service | + | <service |
- | android:name="com.rongkecloud.android.lps.LPSDaemonService" | + | android:name="com.rongkecloud.android.lps.RKPushService" |
android:exported="false" | android:exported="false" | ||
android:process=":remote"/> | android:process=":remote"/> | ||
+ | <service | ||
+ | android:name="com.rongkecloud.android.lps.RKPushNotifyService" | ||
+ | android:enabled="true" | ||
+ | android:exported="false"/> | ||
+ | </code> | ||
+ | 5.配置应用Key到您的AndroidManifest.xml中 | ||
+ | <code xml> | ||
+ | <meta-data | ||
+ | android:name="RKCLOUD_KEY" | ||
+ | android:value="您应用App在互动开发云申请的客户端密钥值" /> | ||
</code> | </code> | ||
===== 使用SDK ===== | ===== 使用SDK ===== | ||
- | 在您的app中做一个触发“连接客服”的事件,在此事件中将您在管理平台生成的配置代码加进去,即可正常使用融智客服客户SDK。 | + | 在您的app中做一个触发“进入直播间”的事件,在此事件中加入如下代码: |
+ | <code java> | ||
+ | RKLivePlayer.getInstance(getApplicationContext()).joinLiveRoom(appKey, roomId, account, password, nickName, themeColor); | ||
+ | </code> | ||
+ | 其中参数说明如下: | ||
+ | *appKey | ||
+ | 不同企业使用SDK的key串,不允许为空,为空返回错误码 | ||
+ | *roomId | ||
+ | 直播间id,不允许为空,为空返回错误码 | ||
+ | *account | ||
+ | 当前用户的账号,允许为空 | ||
+ | *password | ||
+ | 当前观看者的密码口令,和uid无关,不同的密码标识不同的身份,如果创建时没有设置观看者密码则为空,否则返回错误码 | ||
+ | *nickName | ||
+ | 当前用户的昵称,允许为空 | ||
+ | *themeColor | ||
+ | 主题颜色的RGB值,允许为空,默认初始化一种颜色值 | ||
+ | |||
+ | 即可正常使用全互动直播移动SDK。 |