V4

Makefile

@@ -0,0 +1,5 @@
+vet:
+	go vet ./rongcloud
+
+mod:
+	go mod tidy

examples/README.md

@@ -0,0 +1,3 @@
+## RongCloud Go Server SDK Example
+
+当前目录下保留sdk使用示例， 如需更多示例, 非常欢迎提交PR。

examples/chatroom/README.md

@@ -0,0 +1,41 @@
+## 聊天室
+
+### 方法列表
+| 方法名                              | 说明            | 调用示例                                           |
+|----------------------------------|---------------|------------------------------------------------|
+| ChatroomBanAdd                   | 设置聊天室全体禁言     | [chatroomban.go](./chatroomban.go)             |
+| ChatroomBanQuery                 | 查询聊天室全体禁言列表   | [chatroomban.go](./chatroomban.go)             |
+| ChatroomBanRollback              | 取消聊天室全体禁言     | [chatroomban.go](./chatroomban.go)             |
+| ChatroomUserBanWhitelistAdd      | 加入聊天室全体禁言白名单  | [chatroomban.go](./chatroomban.go)             |
+| ChatroomUserBanWhitelistQuery    | 查询聊天室全体禁言白名单  | [chatroomban.go](./chatroomban.go)             |
+| ChatroomUserBanWhitelistRollback | 移出聊天室全体禁言白名单  | [chatroomban.go](./chatroomban.go)             |
+| ChatroomEntrySet                 | 设置聊天室属性（KV）   | [chatroomentry.go.go](./chatroomentry.go.go)   |
+| ChatroomEntryBatchSet            | 批量设置聊天室属性（KV） | [chatroomentry.go](./chatroomentry.go)         |
+| ChatroomEntryRemove              | 删除聊天室属性（KV)   | [chatroomentry.go](./chatroomentry.go)         |
+| ChatroomDestroySet               | 设置聊天室销毁类型     | [chatroommeta.go.go](./chatroommeta.go.go)     |
+| ChatroomGet                      | 查询聊天室信息       | [chatroommeta.go](./chatroommeta.go)           |
+| ChatroomDestroy                  | 销毁聊天室         | [chatroommeta.go](./chatroommeta.go)           |
+| ChatroomUserExist                | 查询用户是否在聊天室中   | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUsersExist               | 批量查询用户是否在聊天室中 | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserQuery                | 获取聊天室成员       | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBlockAdd             | 封禁聊天室用户       | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBlockList            | 查询聊天室封禁用户     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBlockRollback        | 解除封禁聊天室用户     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBanAdd               | 全局禁言用户        | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBanQuery             | 查询全局禁言用户列表    | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserBanRemove            | 取消全局禁言用户      | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserGagAdd               | 禁言指定聊天室用户     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserGagList              | 查询聊天室禁言用户列表   | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomUserGagRollback          | 取消禁言指定聊天室用户   | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomMessagePriorityAdd       | 添加低级别消息类型     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomMessagePriorityQuery     | 查询低级别消息类型     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomMessagePriorityRemove    | 移除低级别消息类型     | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomKeepaliveAdd             | 保活聊天室         | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomKeepaliveQuery           | 查询保活聊天室       | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomKeepaliveRemove          | 取消保活聊天室       | [chatroomuser.go](./chatroomuser.go)           |
+| ChatroomWhitelistAdd             | 加入聊天室消息白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |
+| ChatroomWhitelistQuery           | 查询聊天室消息白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |
+| ChatroomWhitelistRemove          | 移出聊天室消息白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |
+| ChatroomUserWhitelistAdd         | 加入聊天室用户白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |
+| ChatroomUserWhitelistQuery       | 查询聊天室用户白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |
+| ChatroomUserWhitelistRemove      | 移出聊天室用户白名单    | [chatroomwhitelist.go](./chatroomwhitelist.go) |

examples/chatroom/chatroomban.go

@@ -0,0 +1,109 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"log"
+	"os"
+
+	"github.com/rongcloud/server-sdk-go/v4/rongcloud"
+)
+
+func main() {
+	rc := rongcloud.NewRongCloud(os.Getenv("APP_KEY"), os.Getenv("APP_SECRET"))
+	ctx := context.Background()
+
+	chatroomBan(ctx, rc)
+}
+
+func chatroomBan(ctx context.Context, rc *rongcloud.RongCloud) {
+	grp := "grp1"
+	// 创建测试chatroom
+	_, err := rc.ChatroomCreateNew(ctx, &rongcloud.ChatroomCreateNewRequest{ChatroomId: rongcloud.StringPtr(grp)})
+	if err != nil {
+		log.Fatalf("chatroom create error %s", err)
+	}
+
+	banReq := rongcloud.ChatroomBanRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+		Extra:      rongcloud.StringPtr(""),
+		NeedNotify: rongcloud.BoolPtr(true),
+	}
+
+	// 设置聊天室全体禁言
+	banAddRequest := &rongcloud.ChatroomBanAddRequest{
+		ChatroomBanRequest: banReq,
+	}
+	_, err = rc.ChatroomBanAdd(ctx, banAddRequest)
+	if err != nil {
+		log.Fatalf("chatroom ban add error %s", err)
+	}
+
+	// 查询聊天室全体禁言列表
+	banQueryResp, err := rc.ChatroomBanQuery(ctx, &rongcloud.ChatroomBanQueryRequest{
+		Size: rongcloud.IntPtr(50),
+		Page: rongcloud.IntPtr(1),
+	})
+	if err != nil {
+		log.Fatalf("chatroom ban query error %s", err)
+	}
+	banQueryRespData, _ := json.Marshal(banQueryResp)
+	log.Printf("chatroom ban query resp data: %s", banQueryRespData)
+
+	banCheckResp, err := rc.ChatroomBanCheck(ctx, &rongcloud.ChatroomBanCheckRequest{ChatroomId: rongcloud.StringPtr(grp)})
+	if err != nil {
+		log.Fatalf("chatroom ban check error %s", err)
+	}
+	banCheckRespData, _ := json.Marshal(banCheckResp)
+	log.Printf("chatroom ban check resp data: %s", banCheckRespData)
+
+	// 取消聊天室全体禁言
+	banRollbackRequest := &rongcloud.ChatroomBanRollbackRequest{
+		ChatroomBanRequest: banReq,
+	}
+	_, err = rc.ChatroomBanRollback(ctx, banRollbackRequest)
+	if err != nil {
+		log.Fatalf("chatroom ban rollback error %s", err)
+	}
+
+	// 加入聊天室全体禁言白名单
+	userBanWhiteListReq := rongcloud.ChatroomUserBanWhitelistRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+		UserIds:    []string{"u01", "u02"},
+		Extra:      rongcloud.StringPtr(""),
+		NeedNotify: rongcloud.BoolPtr(true),
+	}
+	userBanWhitelistAddReq := &rongcloud.ChatroomUserBanWhitelistAddRequest{
+		ChatroomUserBanWhitelistRequest: userBanWhiteListReq,
+	}
+	_, err = rc.ChatroomUserBanWhitelistAdd(ctx, userBanWhitelistAddReq)
+	if err != nil {
+		log.Fatalf("chatroom user ban whitelist add error %s", err)
+	}
+
+	// 查询聊天室全体禁言白名单
+	userBanWhitelistQueryReq := &rongcloud.ChatroomUserBanWhitelistQueryRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+	}
+	userBanWhitelistQueryResp, err := rc.ChatroomUserBanWhitelistQuery(ctx, userBanWhitelistQueryReq)
+	if err != nil {
+		log.Fatalf("chatroom user ban whitelist query error %s", err)
+	}
+	userBanWhitelistQueryRespData, _ := json.Marshal(userBanWhitelistQueryResp)
+	log.Printf("chatroom user ban whitelist query resp data: %s", userBanWhitelistQueryRespData)
+
+	// 移出聊天室全体禁言白名单
+	userBanWhitelistRollbackReq := &rongcloud.ChatroomUserBanWhitelistRollbackRequest{
+		ChatroomUserBanWhitelistRequest: userBanWhiteListReq,
+	}
+	_, err = rc.ChatroomUserBanWhitelistRollback(ctx, userBanWhitelistRollbackReq)
+	if err != nil {
+		log.Fatalf("chatroom user ban whitelist rollback error %s", err)
+	}
+
+	// 销毁测试chatroom
+	_, err = rc.ChatroomDestroy(ctx, &rongcloud.ChatroomDestroyRequest{ChatroomIds: []string{grp}})
+	if err != nil {
+		log.Fatalf("chatroom create error %s", err)
+	}
+}

examples/chatroom/chatroomentry.go

@@ -0,0 +1,90 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"log"
+	"os"
+
+	"github.com/rongcloud/server-sdk-go/v4/rongcloud"
+)
+
+func main() {
+	rc := rongcloud.NewRongCloud(os.Getenv("APP_KEY"), os.Getenv("APP_SECRET"))
+	ctx := context.Background()
+
+	chatroomEntry(ctx, rc)
+}
+
+func chatroomEntry(ctx context.Context, rc *rongcloud.RongCloud) {
+	grp := "grp1"
+	_, err := rc.ChatroomCreateNew(ctx, &rongcloud.ChatroomCreateNewRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+	})
+	if err != nil {
+		log.Fatalf("chatroom create error: %s", err)
+	}
+
+	// 设置聊天室属性（KV）
+	_, err = rc.ChatroomEntrySet(ctx, &rongcloud.ChatroomEntrySetRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+		UserId:     rongcloud.StringPtr("u01"),
+		Key:        rongcloud.StringPtr("key1"),
+		Value:      rongcloud.StringPtr("val1"),
+		AutoDelete: rongcloud.IntPtr(1),
+		RCMsg: &rongcloud.ChrmKVNotiMsg{
+			Type:  1,
+			Key:   "key1",
+			Value: "val1",
+			Extra: "extra info",
+		},
+	})
+	if err != nil {
+		log.Fatalf("chatroom entry set err %s", err)
+	}
+
+	// 批量设置聊天室属性（KV）
+	_, err = rc.ChatroomEntryBatchSet(ctx, &rongcloud.ChatroomEntryBatchSetRequest{
+		ChatroomId:   rongcloud.StringPtr(grp),
+		AutoDelete:   rongcloud.IntPtr(1),
+		EntryOwnerId: rongcloud.StringPtr("u01"),
+		EntryInfo:    map[string]string{"k1": "k2"},
+	})
+	if err != nil {
+		log.Fatalf("chatroom entry batch set err %s", err)
+	}
+
+	entryQueryResp, err := rc.ChatroomEntryQuery(ctx, &rongcloud.ChatroomEntryQueryRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+		Keys:       []string{"key1"},
+	})
+	if err != nil {
+		log.Fatalf("chatroom entry query error %s", err)
+	}
+	entryQueryRespData, err := json.Marshal(entryQueryResp)
+	log.Printf("chatroom entry query resp: %s", entryQueryRespData)
+
+	// 删除聊天室属性（KV)
+	_, err = rc.ChatroomEntryRemove(ctx, &rongcloud.ChatroomEntryRemoveRequest{
+		ChatroomId: rongcloud.StringPtr(grp),
+		UserId:     rongcloud.StringPtr("u01"),
+		Key:        rongcloud.StringPtr("key1"),
+		RCMsg: &rongcloud.ChrmKVNotiMsg{
+			Type:  2,
+			Key:   "key1",
+			Value: "val1",
+			Extra: "extra info",
+		},
+	})
+	if err != nil {
+		log.Fatalf("chatroom entry remove %s", err)
+	}
+
+	// 销毁测试聊天室
+	_, err = rc.ChatroomDestroy(ctx, &rongcloud.ChatroomDestroyRequest{
+		ChatroomIds: []string{grp},
+	})
+	if err != nil {
+		log.Fatalf("chatroom destroy error: %s", err)
+	}
+}

examples/chatroom/chatroommeta.go

@@ -0,0 +1,60 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"log"
+	"os"
+
+	"github.com/rongcloud/server-sdk-go/v4/rongcloud"
+)
+
+func main() {
+	rc := rongcloud.NewRongCloud(os.Getenv("APP_KEY"), os.Getenv("APP_SECRET"))
+	ctx := context.Background()
+
+	chatroomMetaOp(ctx, rc)
+}
+
+func chatroomMetaOp(ctx context.Context, rc *rongcloud.RongCloud) {
+	// create chatroom
+	resp, err := rc.ChatroomCreateNew(ctx, &rongcloud.ChatroomCreateNewRequest{
+		ChatroomId: rongcloud.StringPtr("grp1"),
+	})
+	if err != nil {
+		log.Fatalf("chatroom create err %s", err)
+	}
+	b, _ := json.Marshal(resp)
+	log.Printf("chat room create resp: %s", b)
+	log.Printf("http response get %+v", resp.GetHttpResponse())
+
+	// 设置聊天室销毁类型
+	destroySetResp, err := rc.ChatroomDestroySet(ctx, &rongcloud.ChatroomDestroySetRequest{
+		ChatroomId:  rongcloud.StringPtr("grp1"),
+		DestroyTime: rongcloud.IntPtr(60),
+		DestroyType: rongcloud.IntPtr(1),
+	})
+	if err != nil {
+		log.Fatalf("chatroom destroy set err %s", err)
+	}
+	destroySetData, _ := json.Marshal(destroySetResp)
+	log.Printf("chatroom destroy set resp: %s", destroySetData)
+
+	// 查询聊天室信息
+	chatroomGetResp, err := rc.ChatroomGet(ctx, &rongcloud.ChatroomGetRequest{ChatroomId: rongcloud.StringPtr("grp1")})
+	if err != nil {
+		log.Fatalf("chatroom get err %s", err)
+	}
+	chatroomGetData, _ := json.Marshal(chatroomGetResp)
+	log.Printf("chatroom get resp: %s", chatroomGetData)
+
+	// 销毁聊天室
+	destroyChatroomResp, err := rc.ChatroomDestroy(ctx, &rongcloud.ChatroomDestroyRequest{
+		ChatroomIds: []string{"grp1", "grp2"},
+	})
+	if err != nil {
+		log.Fatalf("chatroom destroy err %s", err)
+	}
+	destroyChatRoomData, _ := json.Marshal(destroyChatroomResp)
+	log.Printf("chatroom destroy: %s", destroyChatRoomData)
+}