差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
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。 | ||