동작 변경: MMS 사진 문자 전송 예제 및 샘플 이미지 추가

Palbahngmiyine · Palbahngmiyine · commit b03b46750d4c · 2025-10-10T16:18:37.000+09:00
- 새로운 예제 파일 `message_send_mms.rs` 추가: 이미지 업로드를 포함한 MMS 전송 로직 구현.
- 예제 실행 방법 및 환경 변수 설정에 대한 주석 추가: 사용자에게 필요한 정보를 명확히 제공하여 예제 사용을 용이하게 함.
- MMS 전송 예제에 사용될 샘플 이미지 `example.jpg` 추가.
- README.md 파일 업데이트: 새로운 MMS 전송 예제 및 샘플 이미지에 대한 설명 추가.
diff --git a/examples/README.md b/examples/README.md
@@ -8,10 +8,14 @@
 examples/
 ├── message_send_sms.rs           # SMS 단건 전송 (동기 API)
 ├── message_send_lms.rs           # LMS 장문 전송 (동기 API)
+├── message_send_mms.rs           # MMS 사진 문자 전송 (비동기 API, 이미지 업로드 포함)
 ├── message_send_multiple.rs      # 다중 수신자 전송 (동기 API)
 ├── message_send_alimtalk.rs      # 카카오 알림톡 단건 전송 (동기 API)
 ├── message_send_scheduled.rs     # 예약 발송 (동기 API)
 ├── message_send_async.rs         # SMS 전송 (비동기 API)
+├── message_send_voice.rs         # 음성 메시지 전송 (동기 API)
+├── storage_upload_file.rs        # 파일 업로드 (비동기 API)
+├── example.jpg                   # MMS 예제용 샘플 이미지
 └── README.md                     # 이 파일
 ```
 
@@ -24,6 +28,7 @@ examples/
 ```bash
 export SOLAPI_API_KEY="your_api_key"
 export SOLAPI_API_SECRET="your_api_secret"
+# 발송 예제의 경우에만 설정
 export FROM_PHONE="01012345678"  # 발신번호 (사전 등록 필요)
 export TO_PHONE="01087654321"    # 수신번호
 ```
@@ -34,3 +39,77 @@ export TO_PHONE="01087654321"    # 수신번호
 # 프로젝트 루트에서 실행
 cargo run --example message_send_sms
 ```
+
+## 📝 예제 상세 설명
+
+### 메시지 전송 예제
+
+#### SMS 단건 전송
+```bash
+cargo run --example message_send_sms
+```
+- 기본적인 SMS(단문 문자) 전송 예제
+- 동기 API 사용
+
+#### LMS 장문 전송
+```bash
+cargo run --example message_send_lms
+```
+- 최대 2,000byte까지 전송 가능한 장문 문자 예제
+- 제목(subject) 설정 가능
+
+#### MMS 사진 문자 전송
+```bash
+cargo run --example message_send_mms
+# 또는 커스텀 이미지 파일 사용
+cargo run --example message_send_mms <이미지_파일_경로>
+```
+- 이미지가 포함된 MMS 전송 예제
+- Storage API를 통한 이미지 업로드 후 전송
+- 기본적으로 `examples/example.jpg` 사용
+
+#### 다중 수신자 전송
+```bash
+cargo run --example message_send_multiple
+```
+- 한 번의 요청으로 여러 수신자에게 메시지 전송
+
+#### 카카오 알림톡 전송
+```bash
+cargo run --example message_send_alimtalk
+```
+- 카카오톡 알림톡 전송 예제
+- 템플릿 ID와 변수 치환 기능 활용
+
+#### 예약 발송
+```bash
+cargo run --example message_send_scheduled
+```
+- 특정 시간에 메시지를 예약 발송하는 예제
+
+#### 비동기 API 사용
+```bash
+cargo run --example message_send_async
+```
+- Tokio 런타임을 사용한 비동기 메시지 전송 예제
+
+#### 음성 메시지 전송
+```bash
+cargo run --example message_send_voice
+```
+- 음성 메시지(Voice) 전송 예제
+
+### 스토리지 예제
+
+#### 파일 업로드
+```bash
+cargo run --example storage_upload_file <이미지_파일_경로>
+```
+- Storage API를 사용한 파일 업로드 예제
+- MMS 발송 전 이미지 업로드에 사용
+
+## 💡 팁
+
+- MMS 전송 시 이미지는 먼저 Storage API를 통해 업로드한 후 반환된 `file_id`를 사용합니다.
+- 환경 변수는 `.env` 파일을 사용하거나 직접 export로 설정할 수 있습니다.
+- 발신번호는 SOLAPI 콘솔에서 사전 등록이 필요합니다.
diff --git a/examples/example.jpg b/examples/example.jpg
diff --git a/examples/message_send_mms.rs b/examples/message_send_mms.rs
@@ -0,0 +1,131 @@
+//! MMS 사진 문자 전송 예제 (이미지 업로드 포함)
+//!
+//! 실행 방법:
+//! ```bash
+//! cargo run --example message_send_mms
+//! ```
+//!
+//! 환경 변수 설정:
+//! ```bash
+//! export API_KEY="your_api_key"
+//! export API_SECRET="your_api_secret"
+//! export FROM_PHONE="01012345678"
+//! export TO_PHONE="01087654321"
+//! ```
+
+use base64::{engine::general_purpose, Engine as _};
+use solapi::message::{Message, MessageType, SendRequest};
+use solapi::storage::{FileType, UploadFileRequest};
+use solapi::SolapiClient;
+use std::env;
+use std::fs;
+
+/// 파일을 base64로 인코딩하는 헬퍼 함수
+fn read_file_as_base64(file_path: &str) -> Result<String, Box<dyn std::error::Error>> {
+    let file_content = fs::read(file_path)?;
+    Ok(general_purpose::STANDARD.encode(&file_content))
+}
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // 환경 변수에서 API 키 및 전화번호 가져오기
+    let api_key = env::var("API_KEY").expect("API_KEY 환경 변수가 설정되지 않았습니다.");
+    let api_secret = env::var("API_SECRET").expect("API_SECRET 환경 변수가 설정되지 않았습니다.");
+    let from_phone = env::var("FROM_PHONE").expect("FROM_PHONE 환경 변수가 설정되지 않았습니다.");
+    let to_phone = env::var("TO_PHONE").expect("TO_PHONE 환경 변수가 설정되지 않았습니다.");
+
+    // SOLAPI 클라이언트 생성
+    let client = SolapiClient::new(api_key, api_secret);
+
+    // 1단계: 이미지 파일 업로드, 실제 MMS 발송 시 별도의 이미지 파일 경로를 사용하여 발송 해 주세요!
+    println!("=== 1단계: 이미지 업로드 ===");
+    let file_path = env::args()
+        .nth(1)
+        .unwrap_or_else(|| "examples/example.jpg".to_string());
+
+    println!("파일 읽기: {}", file_path);
+
+    // 파일을 base64로 인코딩
+    let base64_content = match read_file_as_base64(&file_path) {
+        Ok(content) => content,
+        Err(e) => {
+            eprintln!("파일 읽기 실패: {}", e);
+            eprintln!("사용법: cargo run --example message_send_mms <파일경로>");
+            return Err(e);
+        }
+    };
+
+    println!(
+        "파일 크기: {} bytes (base64 인코딩 후)",
+        base64_content.len()
+    );
+
+    // 스토리지 서비스로 파일 업로드
+    let storage = client.storage_service();
+    let upload_request = UploadFileRequest {
+        file: base64_content,
+        name: Some(file_path.clone()),
+        file_type: Some(FileType::Mms),
+        link: None,
+    };
+
+    println!("파일 업로드 중...");
+    let upload_response = storage.upload(upload_request).await?;
+
+    println!("✓ 파일 업로드 성공!");
+    println!("  파일 ID: {}", upload_response.file_id);
+    println!("  파일 URL: {}", upload_response.url);
+
+    // 2단계: MMS 메시지 전송
+    println!("\n=== 2단계: MMS 메시지 전송 ===");
+
+    let message_service = client.message_service();
+
+    // MMS 메시지 생성 (업로드된 image_id 사용)
+    let message = Message::new(&to_phone)
+        .from(&from_phone)
+        .text("SOLAPI Rust SDK MMS 테스트\n\n이미지가 첨부된 MMS 메시지입니다.")
+        .message_type(MessageType::MMS)
+        .subject("MMS 발송 테스트");
+
+    // image_id 설정
+    let mut message = message;
+    message.image_id = Some(upload_response.file_id);
+
+    let request = SendRequest {
+        messages: vec![message],
+        allow_duplicates: None,
+        scheduled_date: None,
+        show_message_list: None,
+    };
+
+    println!("MMS 메시지 전송 중...");
+    println!("발신번호: {}", from_phone);
+    println!("수신번호: {}", to_phone);
+
+    // 메시지 전송 (비동기)
+    match message_service.send(request).await {
+        Ok(response) => {
+            println!("\n✓ MMS 전송 성공!");
+            println!("그룹 ID: {}", response.group_info.group_id);
+            println!("상태: {}", response.group_info.status);
+            println!("총 메시지 수: {}", response.group_info.count.total);
+            println!("성공: {}", response.group_info.count.registered_success);
+            println!("실패: {}", response.group_info.count.registered_failed);
+
+            if !response.failed_message_list.is_empty() {
+                println!("\n⚠ 실패한 메시지:");
+                for failed in response.failed_message_list {
+                    println!("  - {}: {}", failed.to, failed.status_message);
+                }
+            }
+        }
+        Err(e) => {
+            eprintln!("\n✗ MMS 전송 실패!");
+            eprintln!("오류: {:?}", e);
+            return Err(e.into());
+        }
+    }
+
+    Ok(())
+}
diff --git a/examples/storage_upload_file.rs b/examples/storage_upload_file.rs
@@ -0,0 +1,72 @@
+use base64::{engine::general_purpose, Engine as _};
+use solapi::storage::{FileType, UploadFileRequest};
+use solapi::SolapiClient;
+use std::env;
+use std::fs;
+
+fn read_file_as_base64(file_path: &str) -> Result<String, Box<dyn std::error::Error>> {
+    let file_content = fs::read(file_path)?;
+    Ok(general_purpose::STANDARD.encode(&file_content))
+}
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // 환경 변수에서 API 키 읽기
+    let api_key = env::var("API_KEY").expect("API_KEY 환경 변수가 설정되지 않았습니다.");
+    let api_secret = env::var("API_SECRET").expect("API_SECRET 환경 변수가 설정되지 않았습니다.");
+
+    // SOLAPI 클라이언트 생성
+    let client = SolapiClient::new(api_key, api_secret);
+    let storage = client.storage_service();
+
+    // 테스트 파일 경로 (예제용 - 실제 파일 경로로 변경 필요)
+    let file_path = env::args()
+        .nth(1)
+        .unwrap_or_else(|| "examples/example.jpg".to_string());
+
+    println!("파일 읽기: {}", file_path);
+
+    // 파일을 base64로 인코딩
+    let base64_content = match read_file_as_base64(&file_path) {
+        Ok(content) => content,
+        Err(e) => {
+            eprintln!("파일 읽기 실패: {}", e);
+            eprintln!("사용법: cargo run --example storage_upload_file <파일경로>");
+            return Err(e);
+        }
+    };
+
+    println!(
+        "파일 크기: {} bytes (base64 인코딩 후)",
+        base64_content.len()
+    );
+
+    // 업로드 요청 생성
+    let request = UploadFileRequest {
+        file: base64_content,
+        name: Some(file_path.clone()),
+        file_type: Some(FileType::Mms),
+        link: None,
+    };
+
+    println!("파일 업로드 중...");
+
+    // 파일 업로드
+    let response = storage.upload(request).await?;
+
+    println!("\n업로드 성공!");
+    println!("파일 ID: {}", response.file_id);
+    println!("파일 이름: {}", response.name);
+    println!("원본 이름: {}", response.original_name);
+    println!("파일 타입: {}", response.file_type);
+    println!("파일 URL: {}", response.url);
+    println!("계정 ID: {}", response.account_id);
+    println!("생성 날짜: {}", response.date_created);
+    println!("수정 날짜: {}", response.date_updated);
+
+    if let Some(link) = response.link {
+        println!("링크: {}", link);
+    }
+
+    Ok(())
+}
