实战教程 编辑文档

本文档将给出一些详尽的示例教程。

如需了解创建应用、读写数据等基础操作,请参考文档 快速入门

教程说明

示例说明

本教程以实时通信文字聊天为例,讲解如何通过 Wilddog Sync 实现实时聊天功能。
在示例中可以支持多人聊天,用户以游客的身份匿名聊天等。百余行代码即可完全实现这些功能,可见 Sync 的简单与强大。

实时聊天示例的最终的效果如下:

具体步骤

1. 安装 SDK

SDK 的安装方式有 2 种:

  • 使用gradle

创建新的工程,在应用级别的build.gradle里添加如下代码

dependencies {
compile 'com.wilddog.client:wilddog-auth-android:2.3.0'
}
  • 使用maven
<dependency>
<groupId>com.wilddog.client</groupId>
<artifactId>wilddog-auth-android</artifactId>
<version>2.3.0</version>
</dependency>

2.建立 SyncReference 引用

初始化一个 SyncReference 对象,该对象连接到 WILDDOG_URL

// 初始化
WilddogOptions options = new WilddogOptions.Builder().setSyncUrl("https://<wilddog appId>.wilddogio.com").build();
WilddogApp.initializeApp(this, options);
SyncReference mWilddogRef = WilddogSync.getInstance().getReference(WILDDOG_URL).child("chat");

3. 监听输入

监听聊天应用的chat节点,一旦有新的聊天内容被增加进去时,客户端会收到推送。

将推送内容解析,并且更新UI界面。

mListener = mWilddogRef.addChildEventListener(new ChildEventListener() {
        @Override
        public void onChildAdded(DataSnapshot dataSnapshot, String previousChildName) {

            T model = (T) dataSnapshot.getValue(WilddogListAdapter.this.mModelClass);
            String key = dataSnapshot.getKey();

            // Insert into the correct location, based on previousChildName
            if (previousChildName == null) {
                mModels.add(0, model);
                mKeys.add(0, key);
            } else {
                int previousIndex = mKeys.indexOf(previousChildName);
                int nextIndex = previousIndex + 1;
                if (nextIndex == mModels.size()) {
                    mModels.add(model);
                    mKeys.add(key);
                } else {
                    mModels.add(nextIndex, model);
                    mKeys.add(nextIndex, key);
                }
            }

            notifyDataSetChanged();
        }

        @Override
        public void onChildChanged(DataSnapshot dataSnapshot, String s) {
            // One of the mModels changed. Replace it in our list and name mapping
            String key = dataSnapshot.getKey();
            T newModel = (T) dataSnapshot.getValue(WilddogListAdapter.this.mModelClass);
            int index = mKeys.indexOf(key);

            mModels.set(index, newModel);

            notifyDataSetChanged();
        }

        @Override
        public void onChildRemoved(DataSnapshot dataSnapshot) {

            // A model was removed from the list. Remove it from our list and the name mapping
            String key = dataSnapshot.getKey();
            int index = mKeys.indexOf(key);

            mKeys.remove(index);
            mModels.remove(index);

            notifyDataSetChanged();
        }

        @Override
        public void onChildMoved(DataSnapshot dataSnapshot, String previousChildName) {

            // A model changed position in the list. Update our list accordingly
            String key = dataSnapshot.getKey();
            T newModel = (T) dataSnapshot.getValue(WilddogListAdapter.this.mModelClass);
            int index = mKeys.indexOf(key);
            mModels.remove(index);
            mKeys.remove(index);
            if (previousChildName == null) {
                mModels.add(0, newModel);
                mKeys.add(0, key);
            } else {
                int previousIndex = mKeys.indexOf(previousChildName);
                int nextIndex = previousIndex + 1;
                if (nextIndex == mModels.size()) {
                    mModels.add(newModel);
                    mKeys.add(key);
                } else {
                    mModels.add(nextIndex, newModel);
                    mKeys.add(nextIndex, key);
                }
            }
            notifyDataSetChanged();
        }

        @Override
        public void onCancelled(WilddogError wilddogError) {
            Log.e("WilddogListAdapter", "Listen was cancelled, no more updates will occur");
        }

    });

网页端的数据结构如下:

4.获取输入

首次调用增加监听方法会将数据直接返回,通过mWilddogRef.limitToLast(50)方法,可以返回最后50条聊天的内容。

mChatListAdapter = new ChatListAdapter(mWilddogRef.limitToLast(50), this, R.layout.chat_message, mUsername);

利用DataSnapshot对象的getValue()方法获取它们的 value 如下 :

T model = (T) dataSnapshot.getValue(WilddogListAdapter.this.mModelClass);
           String key = dataSnapshot.getKey();

6.将聊天内容发送到服务器

通过 push()方法生成一个聊天消息的Id ,然后通过创建Chat对象来封装对应的 value ,并调用 setValue() 把数据推送到服务端。

private void sendMessage() {
    EditText inputText = (EditText) findViewById(R.id.messageInput);
    String input = inputText.getText().toString();
    if (!input.equals("")) {
        // Create our 'model', a Chat object
        Chat chat = new Chat(input, mUsername);
        // Create a new, auto-generated child of that chat location, and save our chat data there
        mWilddogRef.push().setValue(chat);
        inputText.setText("");
    }
}

获取示例源码

点此获取完整的示例源码

野狗新手?
立即注册,为你提供安全可靠的实时通信云服务。
没找到需要的文档?
你可以提交工单反馈 或 阅读常见问题
期待收到你的反馈,帮助我们改进文档。
参与调研