wiki

iOS-升级文档SDK开发指南.md

@@ -14,6 +14,14 @@ PS. 关于Xcode12最低版本支持 iOS 9.0 ，如何联调 iOS 8.0 设备？
 
 [TOC]
 
+## 4.9.1
+
+发布日期：2023.05.17
+
+1.优化聊天图片展示
+2.优化连麦挂断声音异常问题
+3.优化播放加载超时响应逻辑
+
 
 
 ## 4.9.0
@@ -1754,6 +1762,178 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文
 
 
 
+## 3.22.0
+
+发布日期：2023.05.29
+
+1.新增聊天自定义表情功能
+2.新增网络检测页面
+3.SDK层新增文档截图API
+4.修复其他已知问题
+
+### 新增API：
+
+#### 聊天支持自定义表情
+
+##### 房间是否拥有自定义表情使用权限
+
+| 方法                         | 说明                                                         |
+| ---------------------------- | ------------------------------------------------------------ |
+| (BOOL)hasEmojisUsePermission | 房间是否拥有自定义表情使用权限（房间有聊天模版 + 自定义表情开关打开） |
+
+示例代码
+
+```objc
+/**
+ *  @brief 房间是否拥有自定义表情使用权限（房间有聊天模版 + 自定义表情开关打开）
+ */
++ (BOOL)hasEmojisUsePermission;
+```
+
+
+
+##### 每个聊天表情对应的key的集合
+
+| 方法                 | 说明                        |
+| -------------------- | --------------------------- |
+| (NSArray *)emojiKeys | 每个聊天表情对应的key的集合 |
+
+示例代码
+
+```objc
+/**
+ *  @brief 每个聊天表情对应的key的集合
+ */
++ (NSArray *)emojiKeys;
+
+Example code:
+(lldb) po [RequestData emojiKeys]
+<__NSFrozenArrayM 0x11fd8bde0>(
+[大笑],
+[哭],
+[白眼],
+[啊],
+[卖萌],
+[晕],
+[可怜],
+[无语],
+[愤怒],
+[色]
+)
+```
+
+
+
+##### 聊天表情对应plist文件配置表
+
+| 方法                       | 说明                        |
+| -------------------------- | --------------------------- |
+| (NSArray *)emojisPlistInfo | 聊天表情对应plist文件配置表 |
+
+示例代码
+
+```objc
+/**
+ *  @brief 聊天表情对应plist文件配置表
+ */
++ (NSArray *)emojisPlistInfo;
+
+Example code:
+(lldb) po [RequestData emojisPlistInfo]
+<__NSArrayI 0x119ad16d0>(
+{
+    img = "https://cclivematerial.oss-cn-beijing.aliyuncs.com/image/41A6BAB5115465D1/1678179715016_48_1847987378_%E6%99%95.png";
+    name = "[大笑]";
+},
+{
+    img = "https://cclivematerial.oss-cn-beijing.aliyuncs.com/image/41A6BAB5115465D1/1678179674548_24_1542554140_%E5%93%AD.png";
+    name = "[哭]";
+}
+)
+```
+
+
+
+##### 根据表情name获取本地缓存表情image （如果该表情加载失败，会提供占位图）
+
+| 方法                           | 说明                                                         |
+| ------------------------------ | ------------------------------------------------------------ |
+| (UIImage *)emojiCachedForName: | 根据表情name获取本地缓存表情image （如果该表情加载失败，会提供占位图） |
+
+示例代码
+
+```objc
+/**
+ *  @brief 根据表情name获取本地缓存表情image （如果该表情加载失败，会提供占位图）
+ */
++ (UIImage *)emojiCachedForName:(NSString *)emojiName;
+
+Example code:
+(lldb) po [RequestData emojiCachedForName:@"[大笑]"]
+<UIImage: 0x11ff91870>, {27, 27}
+```
+
+
+
+##### 检查自定义聊天表情是否加载完成 （如果加载失败，会再次触发加载逻辑）
+
+| 方法                      | 说明                                                         |
+| ------------------------- | ------------------------------------------------------------ |
+| (BOOL)isEmojiLoadComplete | 检查自定义聊天表情是否加载完成 （如果加载失败，会再次触发加载逻辑） |
+
+示例代码
+
+```objc
+/**
+ *  @brief 检查自定义聊天表情是否加载完成 （如果加载失败，会再次触发加载逻辑）
+ */
+- (BOOL)isEmojiLoadComplete;
+```
+
+
+
+##### 自定义表情加载回调监听
+
+| 方法                        | 说明                       |
+| --------------------------- | -------------------------- |
+| (void)onEmojiLoadingResult: | 自定义聊天表情加载状态回调 |
+
+示例代码
+
+```objc
+/**
+ * @brief 自定义聊天表情加载状态回调
+ */
+- (void)onEmojiLoadingResult:(BOOL)result message:(NSString *)message;
+
+
+Example code:
+
+- (void)onEmojiLoadingResult:(BOOL)result message:(NSString *)message {
+    NSLog(@"%s--%d--%@",__func__,result,message);
+}
+```
+
+
+
+#### 获取文档截图
+
+| 方法                     | 说明         |
+| ------------------------ | ------------ |
+| (UIImage *)getDocThumber | 获取文档截图 |
+
+示例代码
+
+```objc
+/// 3.22.0 new
+/// 获取文档截图
+- (UIImage *)getDocThumber;
+```
+
+
+
+
+
 ## 3.21.0
 
 发布日期：2022.12.29