开放接口使用积累

来源：互联网发布：java高性能并发框架编辑：程序博客网时间：2024/05/18 13:08

个推(消息推送)

官网:http://www.igetui.com/

Demo快速入门说明;

步骤:

用自己的开发者账号登陆个推,进入控制界面;
在左侧菜单中选择 " 应用管理 ==> 应用管理 ==> 登记新应用"
在 "应用名称" 和 "应用标识" 中填入相应内容;
名称随便取,标识是app的package name;
登记完新应用后,单击 " 应用管理 ==> 应用管理 ==> 应用详情 " 中看到各应用对应的详情信息;
下载SDK,解压,在文件夹中的 " 客户端/需要导入的资源 " 中,将armeabi文件夹及GetuiExt-x.x.x.jar、GetuiSdk-x.x.x.x.jar拷贝到项目中的libs目录(若无该目录,自建一个);
在项目的AndroidManifest中增加如下权限和服务声明:
权限:
[html] view plaincopy
1. <uses-permission android:name="android.permission.INTERNET"/>
2. <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
3. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
4. <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
5. <uses-permission android:name="android.permission.WAKE_LOCK"/>
6. <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
7. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
8. <uses-permission android:name="android.permission.VIBRATE"/>
9. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
10. <uses-permission android:name="getui.permission.GetuiService"/>
11. <uses-permission android:name="android.permission.GET_TASKS"/>
13. 
14. <permission
15. android:name="getui.permission.GetuiService"
16. android:protectionLevel="normal">
17. </permission>
在<Application>标签内添加服务声明,并修改相应app信息(参见推控制台中的 " 应用管理 ==> 应用管理 ==> 应用详情 " ):
[html] view plaincopy
1. 
2. 
3. <meta-data
4. android:name="PUSH_APPID"
5. android:value="YOUR_APPID"/>
6. <meta-data
7. android:name="PUSH_APPKEY"
8. android:value="YOUR_APPKEY"/>
9. <meta-data
10. android:name="PUSH_APPSECRET"
11. android:value="YOUR_APPSECRET"/>
12. <meta-data
13. android:name="PUSH_GROUPID"
14. android:value=""/>
15. 
16. <service
17. android:name="com.igexin.sdk.PushService"
18. android:exported="true"
19. android:label="NotificationCenter"
20. android:process=":pushservice">
21. </service>
22. <receiver
23. android:name="com.igexin.sdk.PushReceiver">
24. <intent-filter>
25. <action android:name="android.intent.action.BOOT_COMPLETED"/>
26. <action android:name="android.net.conn.CONNECTIVITY_CHANGE"/>
27. <action android:name="android.intent.action.USER_PRESENT"/>
28. <action android:name="com.igexin.sdk.action.refreshls"/>
29. </intent-filter>
30. </receiver>
31. <receiver
32. android:name="com.igexin.sdk.PushReceiver"
33. android:exported="false">
34. <intent-filter>
35. <action android:name="com.igexin.sdk.action.pushmanager"/>
36. </intent-filter>
37. </receiver>
38. <activity
39. android:name="com.igexin.sdk.PushActivity"
40. android:excludeFromRecents="true"
41. android:exported="false"
42. android:process=":pushservice"
43. android:taskAffinity="com.igexin.sdk.PushActivityTask"
44. android:theme="@android:style/Theme.Translucent.NoTitleBar">
45. </activity>
46. 
47. <activity
48. android:name="com.igexin.getuiext.activity.GetuiExtActivity"
49. android:configChanges="orientation|keyboard|keyboardHidden"
50. android:excludeFromRecents="true"
51. android:process=":pushservice"
52. android:taskAffinity="android.task.myServicetask"
53. android:theme="@android:style/Theme.Translucent.NoTitleBar"
54. android:exported="false"/>
55. <receiver
56. android:name="com.igexin.getuiext.service.PayloadReceiver"
57. android:exported="false">
58. <intent-filter>
59. 
60. <action android:name="com.igexin.sdk.action.7fjUl2Z3LH6xYy7NQK4ni4"/>
61. 
62. <action android:name="com.igexin.sdk.action.YOUR_APPID"/>
63. </intent-filter>
64. </receiver>
65. <service
66. android:name="com.igexin.getuiext.service.GetuiExtService"
67. android:process=":pushservice"/>
68. 
69. <service
70. android:name="com.igexin.download.DownloadService"
71. android:process=":pushservice"/>
72. <receiver
73. android:name="com.igexin.download.DownloadReceiver">
74. <intent-filter>
75. <action android:name="android.net.conn.CONNECTIVITY_CHANGE"/>
76. </intent-filter>
77. </receiver>
78. <provider
79. android:name="com.igexin.download.DownloadProvider"
80. android:process=":pushservice"
81. android:authorities="downloads.com.getui.demo"/>
82.
初始化SDK
[java] view plaincopy
1. import com.igexin.sdk.PushManager;
建议在程序住Activity中的onCreate()方法进行初始化,该方法必须在Activity或Service中进行调用,不建议在Application类中使用:
[java] view plaincopy
1. PushManager.getInstance().initialize(this.getApplicationContext());
配置到此完成,之后在个推控制台中 " 推送通知 ==> 新消息 " 中 "选择应用" 并填写 " 通知标题 " 和 " 通知内容 " 等信息,单击下方的 " 发送通知 " 即可;

友盟(统计/反馈等)

官网: http://www.umeng.com/

开发文档:

统计: http://dev.umeng.com/analytics/android/quick-start
反馈: http://dev.umeng.com/feedback/android/quick-start

作用: 应用统计及用户反馈等

应用统计

注册开发者账号,登录即可进入主页面:
单击左侧 " 下载SDK " 按需下载 , 并 " 添加新应用 " :
解压SDK,将libs目录下的文件合并到本地项目libs目录中;
添加权限:
[html] view plaincopy
1. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
3. <uses-permission android:name="android.permission.INTERNET" />
4. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
在Application标签内设置key值(Appkey可在统计后台的统计分析->设置->应用信息页面查看):
[html] view plaincopy
1. <meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"></meta-data>
2. <meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
"Channel ID" 替换为应用的推广渠道名称,如"google play"
在每个Activity中集成如下代码,以便获取正确的新增用户、活跃用户、启动次数、使用时长等基本数据:
[java] view plaincopy
1. public void onResume() {
2. super.onResume();
3. MobclickAgent.onResume(this);
4. }
6. public void onPause() {
7. super.onPause();
8. MobclickAgent.onPause(this);
9. }
注意:如果Activity之间有继承或者控制关系则不要同时在父和子Activity中重复添加onPause和onResume方法，否则会造成重复统计(eg.使用TabHost、TabActivity、ActivityGroup时)。

当应用在后台运行超过30秒（默认）再回到前端，将被认为是两个独立的session(启动)，例如用户回到home，或进入其他程序，经过一段时间后再返回之前的应用。可通过接口来自定义这个间隔（参数单位为毫秒）：
[java] view plaincopy
1. MobclickAgent.setSessionContinueMillis(long interval)
注意:对于包含fragment的Activity,若要获得更详细的信息,请参看官网文档说明;
设置发送策略:
在程序入口Activity中集成代码:
[java] view plaincopy
1. MobclickAgent.updateOnlineConfig( mContext );
配置结束,启动App,即可登陆umeng后台查看数据;

用户反馈

类似上面的操作,导入用户反馈的jar包,并将res目中layout/drawable/anim下的文件集成到本地项目中;
在项目manifest内声明相关Activity:
[html] view plaincopy
1. 
2. <activity
3. android:name="com.umeng.fb.ConversationActivity"
4. android:theme="@android:style/Theme.NoTitleBar" />
5. <activity
6. android:name="com.umeng.fb.ContactActivity"
7. android:theme="@android:style/Theme.NoTitleBar" />
配置appKey,若上面已设置过,则略过本步:
[html] view plaincopy
1. 
2. <meta-data
3. android:name="UMENG_APPKEY"
4. android:value="your appKey" >
5. </meta-data>
6. <meta-data
7. android:name="UMENG_CHANNEL"
8. android:value="chanel id" />
添加权限:
[html] view plaincopy
1. <uses-permission android:name="android.permission.INTERNET"/>
2. <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
3. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
4. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
5. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
若开发者回复用户反馈后，需要提醒用户,则在程序入口Activity的onCreate()方法中设置:
[java] view plaincopy
1. //友盟反馈意见
2. FeedbackAgent agent = new FeedbackAgent(this);
3. agent.sync();
按需设置页面跳转:
[java] view plaincopy
1. startActivity(mContent, ConversationActivity.class));
完成用户反馈功能集合,若有需要可执行修改layout等文件;

百度地图

官网;

开发文档;

基础地图

文档: http://developer.baidu.com/map/index.php?title=androidsdk/guide/hellobaidumap

准备动作都一样:注册开发者账号,登记应用,获取appID等信息;
登录后,单击右上角的" API控制台 ==> 创建应用 " ,按需填入信息即可获得 " 访问应用(ak) ",就是后面需要用到的密匙key了;
注意; 安全码由 " 数字签名 + 分号 + 包名 " 组成,其中数字签名在 Eclipse ==> window ==> preferences ==> Android ==> Build ==> SHA1 fingerprint;
下载所需的sdk;
合并libs目录:
将armeabi目录下的libBaiduMapSDK_vx_x_x.so拷贝到本地项目同名文件夹内;
将BaiduLBS_Android.jar拷贝到本地项目libs目录内;
配置Manifest:
在application标签内添加密匙key:
[html] view plaincopy
1. <meta-data
2. android:name="com.baidu.lbsapi.API_KEY"
3. android:value="your key" />
添加权限:
[html] view plaincopy
1. 
2. <uses-permission android:name="android.permission.GET_ACCOUNTS" />
3. <uses-permission android:name="android.permission.USE_CREDENTIALS" />
4. <uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />
5. <uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS" />
6. <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
7. <uses-permission android:name="android.permission.BROADCAST_STICKY" />
8. <uses-permission android:name="android.permission.WRITE_SETTINGS" />
9. 
10. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
11. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
12. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
13. <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
14. <uses-permission android:name="android.permission.INTERNET" />
15. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
在Activity的布局xml文件件中添加地图控件:
[html] view plaincopy
1. <com.baidu.mapapi.map.MapView
2. android:id="@+id/bmapView"
3. android:layout_width="match_parent"
4. android:layout_height="match_parent"
5. android:clickable="true" />
在程序中初始化百度地图SDK并管理其生命周期:
[java] view plaincopy
1. public class MainActivity extends Activity {
2. MapView mMapView = null;
3. @Override
4. protected void onCreate(Bundle savedInstanceState) {
5. super.onCreate(savedInstanceState);
6. //在使用SDK各组件之前初始化context信息，传入ApplicationContext
7. //注意该方法要再setContentView方法之前实现
8. SDKInitializer.initialize(getApplicationContext());
9. setContentView(R.layout.activity_main);
10. //获取地图控件引用
11. mMapView = (MapView) findViewById(R.id.bmapView);
12. }
13. @Override
14. protected void onDestroy() {
15. super.onDestroy();
16. //在activity执行onDestroy时执行mMapView.onDestroy()，实现地图生命周期管理
17. mMapView.onDestroy();
18. }
19. @Override
20. protected void onResume() {
21. super.onResume();
22. //在activity执行onResume时执行mMapView. onResume ()，实现地图生命周期管理
23. mMapView.onResume();
24. }
25. @Override
26. protected void onPause() {
27. super.onPause();
28. //在activity执行onPause时执行mMapView. onPause ()，实现地图生命周期管理
29. mMapView.onPause();
30. }
31. }

定位功能

类参考: http://developer.baidu.com/map/android_refer/index.html

http://developer.baidu.com/map/geosdk-android-classv4.0.htm

下载SDK,解压后将libs下的BaiduLBS_Android.jar 、locSDK_3.1.jar及 armeabi下的libBaiduMapSDK_v3_1_0.so、liblocSDK4d.so拷贝到项目中;
配置Manifest:
设置密匙key:
[html] view plaincopy
1. <meta-data
2. android:name="com.baidu.lbsapi.API_KEY"
3. android:value="your key" />
添加权限:
[html] view plaincopy
1. 
2. 
3. <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
4. 
5. <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
6. 
7. <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
8. 
9. <uses-permission android:name="android.permission.READ_LOGS" />
11. 
12. 
13. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
14. 
15. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
16. 
17. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
18. 
19. <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
20. 
21. <uses-permission android:name="android.permission.INTERNET" />
22. 
23. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
添加服务:
[html] view plaincopy
1. 
2. <service
3. android:name="com.baidu.location.f"
4. android:enabled="true"
5. android:process=":remote" />
同地图基础功能中第5/6条 : 添加地图控件及生命周期管理;
在onCreate()方法中初始化定位功能并运行:
[java] view plaincopy
1. super.onCreate(savedInstanceState);
2. SDKInitializer.initialize(getApplicationContext());
3. setContentView(R.layout.activity_main);
4. // 地图初始化
5. mMapView = (MapView) findViewById(R.id.bmapView);
6. mBaiduMap = mMapView.getMap();
7. // 定位
8. mCurrentMode = LocationMode.NORMAL;
9. mBaiduMap.setMyLocationConfigeration(new MyLocationConfiguration(
10. mCurrentMode, true, mCurrentMarker));
11. // 地图初始化显示精度
12. MapStatus mMapStatus = new MapStatus.Builder().zoom(14).build();
13. MapStatusUpdate mMapStatusUpdate = MapStatusUpdateFactory
14. .newMapStatus(mMapStatus);
15. mBaiduMap.setMapStatus(mMapStatusUpdate);
16. // 开启定位图层
17. mBaiduMap.setMyLocationEnabled(true);
18. // 定位初始化
19. mLocClient = new LocationClient(this);
20. mLocClient.registerLocationListener(myListener);//myListener为自定义监听函数,见下一步
21. LocationClientOption option = new LocationClientOption();
22. option.setOpenGps(true);// 打开gps
23. option.setCoorType("bd09ll"); // 设置坐标类型
24. option.setScanSpan(1000);
25. mLocClient.setLocOption(option);
26. //別忘了运行
27. mLocClient.start();
其中 " mMapStatus = new MapStatus.Builder().zoom(14).build(); "用于设定地图初始化精度范围:
[java] view plaincopy
1. //百度地图初始化精度
2. int BAIDU_MAP_5KM = 12;
3. int BAIDU_MAP_2KM = 13;
4. int BAIDU_MAP_1KM = 14;
5. int BAIDU_MAP_500M = 15;
6. int BAIDU_MAP_200M = 16;
7. int BAIDU_MAP_100M = 17;
8. int BAIDU_MAP_50M = 18;
设置定位SDK监听函数:
[java] view plaincopy
1. public class MyLocationListenner implements BDLocationListener {
3. @Override
4. public void onReceiveLocation(BDLocation location) {
5. // map view 销毁后不在处理新接收的位置
6. if (location == null || mMapView == null)
7. return;
8. float radius = location.getRadius();
9. MyLocationData locData = new MyLocationData.Builder()
10. .accuracy(radius)
11. // 此处设置开发者获取到的方向信息，顺时针0-360
12. .direction(100).latitude(location.getLatitude())
13. .longitude(location.getLongitude()).build();
14. mBaiduMap.setMyLocationData(locData);
15. if (isFirstLoc) {
16. isFirstLoc = false;
17. LatLng ll = new LatLng(location.getLatitude(),
18. location.getLongitude());
19. MapStatusUpdate u = MapStatusUpdateFactory.newLatLng(ll);
20. mBaiduMap.animateMapStatus(u);
21. }
22. <span style="white-space:pre"> </span>// 添加悬浮物
23. initOverlay(location);
24. }
26. public void onReceivePoi(BDLocation poiLocation) {
27. }
28. }
添加悬浮物函数:
[java] view plaincopy
1. // 设置悬浮物
2. private boolean isShowInfoWindow;
3. private InfoWindow mInfoWindow;
5. public void initOverlay(BDLocation location) {
6. // 定义Maker坐标点
7. LatLng point = new LatLng(location.getLatitude() + 0.01,
8. location.getLongitude() + 0.01);
9. // 构建Marker图标
10. BitmapDescriptor bitmap = BitmapDescriptorFactory
11. .fromResource(R.drawable.icon_tab_near_pressed);
12. // 构建MarkerOption，用于在地图上添加Marker
13. OverlayOptions option = new MarkerOptions().position(point)
14. .icon(bitmap);
15. markerA = (Marker) mBaiduMap.addOverlay(option);
16. // Marker点击事件
17. mBaiduMap.setOnMarkerClickListener(new OnMarkerClickListener() {
19. @Override
20. public boolean onMarkerClick(Marker arg0) {
21. if (isShowInfoWindow) {
22. mBaiduMap.hideInfoWindow();
23. isShowInfoWindow = false;
24. } else {
25. View overlayButton = getLayoutInflater().inflate(
26. R.layout.overlay, null);
27. final LatLng ll = markerA.getPosition();
29. /*
30. * getProjection()获取地图投影坐标转换器, 当地图初始化完成之前返回 null，在
31. * OnMapLoadedCallback.onMapLoaded() 之后才能正常;
32. * Projection接口用于屏幕像素点坐标系统和地球表面经纬度点坐标系统之间的变换
33. */
35. /**
36. * public Point toScreenLocation(LatLng location)
37. * 将地理坐标转换成屏幕坐标参数: location - 地理坐标如果传入 null 则返回null 返回:
38. * 屏幕坐标
39. */
40. Point p = mBaiduMap.getProjection().toScreenLocation(ll);
41. p.y -= 40;
42. LatLng llInfo = mBaiduMap.getProjection()
43. .fromScreenLocation(p);
44. OnInfoWindowClickListener listener = new OnInfoWindowClickListener() {
46. @Override
47. public void onInfoWindowClick() {
48. Toast.makeText(MainActivity.this, "悬浮物点击事件",
49. Toast.LENGTH_SHORT).show();
50. }
51. };
53. // InfoWindow 在地图中显示一个信息窗口，可以设置一个View作为该窗口的内容，也可以设置一个
54. // BitmapDescriptor 作为该窗口的内容。
55. mInfoWindow = new InfoWindow(overlayButton, llInfo,
56. listener);
57. mBaiduMap.showInfoWindow(mInfoWindow);
58. isShowInfoWindow = true;
59. }
60. return false;
61. }
62. });
63. }
效果如下:

Demo源文件下载地址;
如果只是单纯想得到经纬度，则不必添加组件，前两步还是一样：
[java] view plaincopy
1. // 定位
2. LocationClient mLocClient;
3. public MyLocationListenner myListener = new MyLocationListenner();
4. private LocationMode mCurrentMode;
5. BitmapDescriptor mCurrentMarker;
6. boolean isFirstLoc = true;// 是否首次定位
7. private String tvCityLatLng;
9. private void initLocation() {
10. // 定位初始化
11. mCurrentMode = LocationMode.NORMAL;
12. mLocClient = new LocationClient(this);
13. mLocClient.registerLocationListener(myListener);
14. LocationClientOption option = new LocationClientOption();
15. option.setOpenGps(true);// 打开gps
16. option.setCoorType("bd09ll"); // 设置坐标类型
17. option.setScanSpan(1000);
18. mLocClient.setLocOption(option);
19. mLocClient.start();
20. }
设置监听：
[java] view plaincopy
1. public class MyLocationListenner implements BDLocationListener {
3. @Override
4. public void onReceiveLocation(BDLocation location) {
5. if (location == null) {
6. return;
7. }
8. if (isFirstLoc) {
9. isFirstLoc = false;
10. LatLng ll = new LatLng(location.getLatitude(),
11. location.getLongitude());
12. <span style="white-space:pre"> </span>//这里我写成http网址形式，是之前用于发短信的，可以直接通过连接打开谷歌地图进行定位
13. tvCityLatLng = "http://ditu.google.cn/?q="
14. + location.getLatitude() + ","
15. + location.getLongitude();
16. System.out.println("首次定位坐标: " + tvCityLatLng);
17. }
18. }
19. public void onReceivePoi(BDLocation poiLocation) {
20. }
21. }
生命周期管理：
[java] view plaincopy
1. @Override
2. protected void onDestroy() {
3. super.onDestroy();
4. // 退出时销毁定位
5. mLocClient.stop();
6. }
备注：若在程序运行期间需要多次用到定位，则在监听事件MyLocationListenner()内if条件语句中添加标志位进行判断即可;

引用：http://blog.csdn.net/zxz_tsgx/article/details/38503917

推荐阅读:Eclipse软件问题-方案积累

0 0