udpate add addUploadProgressListener in docs

Author: huangminlinux

document/API.md

@@ -1196,3 +1196,21 @@ JMessage.removeMessageRetractListener(listener) // 移除监听(一般在 compon
   - type:  'user_password_change' / 'user_logout' / 'user_deleted' / 'user_login_status_unexpected'
 
 
+#### addUploadProgressListener
+
+发送文件（图片、文件）进度回调，该回调会回调多次。
+
+##### 示例
+
+```javascript
+var listener = (result) => { }
+
+JMessage.addUploadProgressListener(listener) // 添加监听
+JMessage.removeUploadProgressListener(listener) // 移除监听(一般在 componentWillUnmount 中调用)
+```
+
+##### 回调参数说明
+
+- result
+  - messageId：消息 id。
+  - progress：上传进度，从 0-1 float 类型。

ios/RCTJMessageModule/RCTJMessageModule.m

@@ -488,6 +488,12 @@ - (JMSGOptionalContent *)convertDicToJMSGOptionalContent:(NSDictionary *)dic {
 
   if ([param[@"type"] isEqual: @"single"] && param[@"username"] != nil) {
     JMSGImageContent *content = [[JMSGImageContent alloc] initWithImageData: [NSData dataWithContentsOfFile: mediaPath]];
+    
+    content.uploadHandler = ^(float percent, NSString *msgID) {
+      [self.bridge.eventDispatcher sendAppEventWithName:uploadProgressEvent body:@{@"messageId": msgID,
+                                                                                   @"progress": @(percent)}];
+    };
+    
     JMSGMessage *message = [JMSGMessage createSingleMessageWithContent:content username: param[@"username"]];
     if (param[@"extras"] && [param[@"extras"] isKindOfClass: [NSDictionary class]]) {
       NSDictionary *extras = param[@"extras"];
@@ -513,6 +519,13 @@ - (JMSGOptionalContent *)convertDicToJMSGOptionalContent:(NSDictionary *)dic {
 
   } else if ([param[@"type"] isEqual: @"group"] && param[@"groupId"] != nil) {
     JMSGImageContent *content = [[JMSGImageContent alloc] initWithImageData: [NSData dataWithContentsOfFile: mediaPath]];
+    
+    content.uploadHandler = ^(float percent, NSString *msgID) {
+      
+      [self.bridge.eventDispatcher sendAppEventWithName:uploadProgressEvent body:@{@"messageId": msgID,
+                                                                                   @"progress": @(percent)}];
+    };
+    
     JMSGMessage *message = [JMSGMessage createGroupMessageWithContent: content groupId: param[@"groupId"]];
     if (param[@"extras"] && [param[@"extras"] isKindOfClass: [NSDictionary class]]) {
       NSDictionary *extras = param[@"extras"];
@@ -794,6 +807,12 @@ - (JMSGOptionalContent *)convertDicToJMSGOptionalContent:(NSDictionary *)dic {
   if ([param[@"type"] isEqual: @"single"] && param[@"username"] != nil) {
     // send single text message
     JMSGFileContent *content = [[JMSGFileContent alloc] initWithFileData:[NSData dataWithContentsOfFile: mediaPath] fileName: fileName];
+    
+    content.uploadHandler = ^(float percent, NSString *msgID) {
+      [self.bridge.eventDispatcher sendAppEventWithName:uploadProgressEvent body:@{@"messageId": msgID,
+                                                                                   @"progress": @(percent)}];
+    };
+    
     JMSGMessage *message = [JMSGMessage createSingleMessageWithContent:content username: param[@"username"]];
     if (param[@"extras"] && [param[@"extras"] isKindOfClass: [NSDictionary class]]) {
       NSDictionary *extras = param[@"extras"];
@@ -818,6 +837,12 @@ - (JMSGOptionalContent *)convertDicToJMSGOptionalContent:(NSDictionary *)dic {
     if ([param[@"type"] isEqual: @"group"] && param[@"groupId"] != nil) {
       // send group text message
       JMSGFileContent *content = [[JMSGFileContent alloc] initWithFileData:[NSData dataWithContentsOfFile: mediaPath] fileName: fileName];
+      
+      content.uploadHandler = ^(float percent, NSString *msgID) {
+        [self.bridge.eventDispatcher sendAppEventWithName:uploadProgressEvent body:@{@"messageId": msgID,
+                                                                                     @"progress": @(percent)}];
+      };
+      
       JMSGMessage *message = [JMSGMessage createGroupMessageWithContent: content groupId: param[@"groupId"]];
       if (param[@"extras"] && [param[@"extras"] isKindOfClass: [NSDictionary class]]) {
         NSDictionary *extras = param[@"extras"];