วันอังคารที่ 12 ธันวาคม พ.ศ. 2560

6.Social Components

Social Components - App Inventor for Android
Table of Contents

    ContactPicker
    EmailPicker
    PhoneCall
    PhoneNumberPicker
    Sharing
    Texting
    Twitter
ContactPicker
ปุ่มที่เมื่อคลิกแล้วจะแสดงรายการที่ติดต่อเพื่อเลือกระหว่าง หลังจากที่ผู้ใช้ทำการเลือกแล้วคุณสมบัติต่อไปนี้จะถูกตั้งค่าเป็นข้อมูลเกี่ยวกับผู้ติดต่อที่เลือก:
ContactName: ชื่อของที่ติดต่อ
    EmailAddress: ที่อยู่อีเมลหลักของผู้ติดต่อ
    EmailAddressList: รายการที่อยู่อีเมลของผู้ติดต่อ
    ContactUri: URI ของที่ติดต่อบนอุปกรณ์
    PhoneNumber: หมายเลขโทรศัพท์หลักของผู้ติดต่อ (ในภายหลัง Android Verisons)
    PhoneNumberList: รายการหมายเลขโทรศัพท์ของผู้ติดต่อ (ใน Android เวอร์ชันหลัง)
    รูปภาพ: ชื่อของไฟล์ที่มีภาพของผู้ติดต่อซึ่งสามารถใช้เป็นค่า Picture property สำหรับ Image หรือ ImageSprite ได้

คุณสมบัติอื่น ๆ มีผลต่อลักษณะที่ปรากฏของปุ่ม (TextAlignment, BackgroundColor ฯลฯ ) และไม่ว่าจะสามารถคลิกได้ (Enabled)

คอมโพเนนต์ ContactPicker อาจไม่ทำงานบนโทรศัพท์ทั้งหมด ตัวอย่างเช่นในระบบ Android ก่อนระบบ 3.0 จะไม่สามารถเลือกหมายเลขโทรศัพท์ได้และรายการที่อยู่อีเมลจะมีเพียงอีเมลเดียวเท่านั้น

Properties
สีพื้นหลัง
    แสดงสีพื้นหลังของปุ่ม
ชื่อผู้ติดต่อ
ที่อยู่อีเมล
ContactUri
    URI ที่ระบุตำแหน่งของที่อยู่ติดต่อในอุปกรณ์
เปิดการใช้งาน
FontBold (ผู้ออกแบบเท่านั้น)
FontItalic (ผู้ออกแบบเท่านั้น)
FontSize (ผู้ออกแบบเท่านั้น)
FontTypeface (ผู้ออกแบบเท่านั้น)

ความสูง
ภาพ
    ระบุเส้นทางของรูปภาพของปุ่ม หากมีภาพและ BackgroundColor มีเพียงภาพเท่านั้นที่สามารถมองเห็นได้
ภาพ
รูปร่าง (เฉพาะผู้ออกแบบ)
    ระบุรูปร่างของปุ่ม (ค่าเริ่มต้นกลมสี่เหลี่ยมรูปวงรี) รูปร่างจะไม่ปรากฏหากมีการแสดงภาพ
ShowFeedback
    ระบุว่าควรแสดงความคิดเห็นภาพสำหรับปุ่มที่เป็นภาพเป็นพื้นหลังหรือไม่
ข้อความ
TextAlignment (ผู้ออกแบบเท่านั้น)
Textcolor
มองเห็นได้
    ระบุว่าจะให้คอมโพเนนต์ปรากฏบนหน้าจอหรือไม่ ค่าเป็นจริงถ้าคอมโพเนนต์แสดงและเท็จถ้าซ่อนไว้
ความกว้าง

เหตุการณ์ที่เกิดขึ้น

AfterPicking ()
    กิจกรรมที่เรียบง่ายที่จะยกขึ้นหลังจากที่กิจกรรมของตัวดึงข้อมูลจะส่งกลับผลการค้นหาและคุณสมบัติได้รับการเติมเต็ม
BeforePicking ()
    เหตุการณ์ง่ายที่จะเพิ่มขึ้นเมื่อมีการคลิกคอมโพเนนต์ แต่ก่อนที่กิจกรรมตัวเลือกจะเริ่มต้น
GotFocus ()
    บ่งชี้ว่าเคอร์เซอร์เลื่อนไปเหนือปุ่มเพื่อให้สามารถคลิกได้
LostFocus ()
    บ่งบอกว่าเคอร์เซอร์เลื่อนออกไปจากปุ่มเพื่อไม่ให้คลิกที่นี่อีกต่อไป

วิธีการ

เปิด()
    เปิดตัวเลือกราวกับว่าผู้ใช้คลิกที่ตัวเลือก
ViewContact (URI)
    ดูรายชื่อติดต่อที่ระบุ URI

EmailPicker

EmailPicker เป็นกล่องข้อความประเภทหนึ่ง หากผู้ใช้ป้อนชื่อหรือที่อยู่อีเมลของผู้ติดต่อโทรศัพท์จะแสดงเมนูแบบเลื่อนลงของตัวเลือกที่กรอกข้อมูล หากมีที่อยู่ติดต่อหลายรายการเมนูแบบเลื่อนลงอาจใช้เวลาหลายวินาทีในการแสดงและสามารถแสดงผลกลางระหว่างที่กำลังคำนวณผลการแข่งขัน

เนื้อหาเริ่มต้นของกล่องข้อความและเนื้อหา <after user entry อยู่ใน Text property ถ้าคุณสมบัติ Text ว่างเปล่าเป็นครั้งแรกเนื้อหาของคำแนะนำจะถูกแสดงอย่างเบา ๆ ในกล่องข้อความเพื่อเป็นคำใบ้ให้กับผู้ใช้

คุณสมบัติอื่น ๆ มีผลต่อลักษณะที่ปรากฏของกล่องข้อความ (TextAlignment, BackgroundColor ฯลฯ ) และไม่ว่าจะสามารถใช้งานได้ (Enabled)

กล่องข้อความเช่นนี้มักใช้กับส่วนประกอบของปุ่มโดยผู้ใช้คลิกที่ปุ่มเมื่อป้อนข้อความเสร็จสมบูรณ์

ความสูง
เปรย
    ข้อความที่ควรปรากฏอย่างเฉียบพลันในช่องใส่เพื่อให้คำแนะนำว่าผู้ใช้ควรใส่อะไร สิ่งนี้สามารถมองเห็นได้เฉพาะเมื่อพร็อพเพอร์ตี้ Text ว่างเปล่า
ข้อความ
    ข้อความในกล่องป้อนข้อมูลซึ่งสามารถตั้งค่าโดยโปรแกรมเมอร์ในตัวแก้ไขดีไซน์หรือบล็อกหรือผู้ใช้สามารถป้อนได้ (เว้นแต่ว่าคุณสมบัติที่เปิดใช้งานเป็นเท็จ)
TextAlignment (ผู้ออกแบบเท่านั้น)
    ไม่ว่าจะเป็นข้อความที่ถูกต้องกลางหรือด้านขวาถูกต้อง โดยค่าเริ่มต้นข้อความจะถูกปล่อยให้พอดี
Textcolor
    สีของข้อความ คุณสามารถเลือกสีตามชื่อใน Designer หรือใน Blocks Editor สีข้อความเริ่มต้นเป็นสีดำ
มองเห็นได้
    ระบุว่าจะให้คอมโพเนนต์ปรากฏบนหน้าจอหรือไม่ ค่าเป็นจริงถ้าคอมโพเนนต์แสดงและเท็จถ้าซ่อนไว้

ความกว้าง

เหตุการณ์ที่เกิดขึ้น

GotFocus ()
    กิจกรรมยกขึ้นเมื่อเลือกส่วนประกอบนี้สำหรับการป้อนข้อมูลเช่นโดยผู้ใช้สัมผัส
LostFocus ()
    เหตุการณ์ยกขึ้นเมื่อไม่มีการเลือกส่วนประกอบนี้สำหรับการป้อนข้อมูลเช่นถ้าผู้ใช้สัมผัสกล่องข้อความอื่น

Methods
none
PhoneCall

คอมโพเนนต์ที่มองไม่เห็นซึ่งทำให้โทรศัพท์ติดต่อไปยังหมายเลขที่ระบุในคุณสมบัติ PhoneNumber ซึ่งสามารถตั้งค่าได้ทั้งในตัวแก้ไขออกแบบหรือบล็อค คอมโพเนนต์มีเมธอด MakePhoneCall ทำให้โปรแกรมสามารถเรียกใช้การโทรศัพท์ได้ คอมโพเนนต์ ContactPicker นี้จะใช้กับคอมโพเนนต์ ContactPicker ซึ่งจะช่วยให้ผู้ใช้เลือกรายชื่อติดต่อจากที่เก็บอยู่ในโทรศัพท์และตั้งค่า PhoneNumber ให้เป็นหมายเลขโทรศัพท์ของผู้ติดต่อ หากต้องการระบุหมายเลขโทรศัพท์โดยตรง (เช่น 650-555-1212) ให้ตั้งค่าคุณสมบัติ PhoneNumber เป็นข้อความที่มีตัวเลขที่ระบุ (เช่น "6505551212") อาจมีเครื่องหมายขีดคั่นจุดและวงเล็บ (เช่น "(650) -555-1212") แต่จะถูกละเลย ช่องว่างอาจไม่รวมอยู่

คุณสมบัติ

หมายเลขโทรศัพท์

เหตุการณ์ที่เกิดขึ้น

IncomingCallAnswered (หมายเลขโทรศัพท์แบบข้อความ)
    กิจกรรมที่ระบุว่ามีการตอบรับสายเรียกเข้า หมายเลขโทรศัพท์คือหมายเลขโทรศัพท์สายเรียกเข้า
PhoneCallEnded (สถานะหมายเลขหมายเลขโทรศัพท์ข้อความ)
    กิจกรรมที่ระบุว่ามีการโทรติดต่อสิ้นสุดลง หากสถานะเป็น 1 สายเรียกเข้าจะพลาดหรือถูกปฏิเสธ หากสถานะเป็น 2 จะมีการตอบรับสายเรียกเข้าก่อนวางสาย ถ้าสถานะเป็น 3 สายที่โทรออกถูกแขวนไว้ หมายเลขโทรศัพท์คือหมายเลขโทรศัพท์สายที่สิ้นสุด
PhoneCallStarted (สถานะหมายเลขหมายเลขโทรศัพท์ข้อความ)
    เหตุการณ์ที่ระบุว่ามีการเปิดใช้ phonecall แล้ว หากสถานะเป็น 1 สายเรียกเข้าจะดังขึ้น หากสถานะเป็น 2 จะมีการโทรออก หมายเลขโทรศัพท์คือหมายเลขโทรศัพท์ขาเข้า / ขาออก


วิธีการ

MakePhoneCall ()
    ทำการโทรศัพท์โดยใช้หมายเลขในคุณสมบัติ PhoneNumber

PhoneNumberPicker

ปุ่มที่เมื่อคลิกแล้วจะแสดงรายการหมายเลขโทรศัพท์ของผู้ติดต่อเพื่อเลือกระหว่าง หลังจากที่ผู้ใช้ทำการเลือกแล้วคุณสมบัติต่อไปนี้จะถูกตั้งค่าเป็นข้อมูลเกี่ยวกับผู้ติดต่อที่เลือก:

    ContactName: ชื่อของที่ติดต่อ
    PhoneNumber: หมายเลขโทรศัพท์ของผู้ติดต่อ
    EmailAddress: ที่อยู่อีเมลของผู้ติดต่อ
    รูปภาพ: ชื่อของไฟล์ที่มีภาพของผู้ติดต่อซึ่งสามารถใช้เป็นค่า Picture property สำหรับ Image หรือ ImageSprite ได้

คุณสมบัติอื่น ๆ มีผลต่อลักษณะที่ปรากฏของปุ่ม (TextAlignment, BackgroundColor ฯลฯ ) และไม่ว่าจะสามารถคลิกได้ (Enabled)

คอมโพเนนต์ PhoneNumberPicker อาจไม่ทำงานบนอุปกรณ์ Android ทั้งหมด ตัวอย่างเช่นในระบบ Android ก่อนระบบ 3.0 รายชื่อหมายเลขโทรศัพท์และที่อยู่อีเมลที่ส่งกลับจะว่างเปล่า


คุณสมบัติ

สีพื้นหลัง
    แสดงสีพื้นหลังของปุ่ม
ชื่อผู้ติดต่อ
ที่อยู่อีเมล
เปิดการใช้งาน
FontBold (ผู้ออกแบบเท่านั้น)
FontItalic (ผู้ออกแบบเท่านั้น)
FontSize (ผู้ออกแบบเท่านั้น)
FontTypeface (ผู้ออกแบบเท่านั้น)
ความสูง
ภาพ
    ระบุเส้นทางของรูปภาพของปุ่ม หากมีภาพและ BackgroundColor มีเพียงภาพเท่านั้นที่สามารถมองเห็นได้
หมายเลขโทรศัพท์
ภาพ
รูปร่าง (เฉพาะผู้ออกแบบ)
    ระบุรูปร่างของปุ่ม (ค่าเริ่มต้นกลมสี่เหลี่ยมรูปวงรี) รูปร่างจะไม่ปรากฏหากมีการแสดงภาพ
ShowFeedback
    ระบุว่าควรแสดงความคิดเห็นภาพสำหรับปุ่มที่เป็นภาพเป็นพื้นหลังหรือไม่
ข้อความ
TextAlignment (ผู้ออกแบบเท่านั้น)
Textcolor
มองเห็นได้
    ระบุว่าจะให้คอมโพเนนต์ปรากฏบนหน้าจอหรือไม่ ค่าเป็นจริงถ้าคอมโพเนนต์แสดงและเท็จถ้าซ่อนไว้
ความกว้าง


เหตุการณ์ที่เกิดขึ้น

AfterPicking ()
    กิจกรรมที่เรียบง่ายที่จะยกขึ้นหลังจากที่กิจกรรมของตัวดึงข้อมูลจะส่งกลับผลลัพธ์และคุณสมบัติได้รับการเติมเต็ม
BeforePicking ()
    เหตุการณ์ง่าย ๆ ที่จะเพิ่มขึ้นเมื่อมีการคลิกคอมโพเนนต์ แต่ก่อนที่กิจกรรมตัวเลือกจะเริ่มต้นขึ้น
GotFocus ()
    บ่งชี้ว่าเคอร์เซอร์เลื่อนไปเหนือปุ่มเพื่อให้สามารถคลิกได้
LostFocus ()
    บ่งบอกว่าเคอร์เซอร์เลื่อนออกไปจากปุ่มเพื่อไม่ให้คลิกที่นี่อีกต่อไป

วิธีการ

เปิด()
    เปิดตัวเลือกราวกับว่าผู้ใช้คลิกที่ตัวเลือก

ที่ใช้ร่วมกัน

การแบ่งปันเป็นคอมโพเนนต์ที่มองไม่เห็นซึ่งช่วยให้สามารถแชร์ไฟล์และ / หรือข้อความระหว่างแอปกับแอพอื่น ๆ ที่ติดตั้งบนอุปกรณ์ได้ คอมโพเนนต์จะแสดงรายการแอปที่ติดตั้งไว้ซึ่งสามารถจัดการกับข้อมูลที่ให้มาได้และจะช่วยให้ผู้ใช้สามารถเลือกเนื้อหาเพื่อแชร์เนื้อหาเช่นแอปเมลแอปเครือข่ายสังคมแอปพลิเคชัน texting เป็นต้น
เส้นทางของไฟล์สามารถนำมาจากส่วนประกอบอื่น ๆ ได้โดยตรงเช่นกล้องหรือ ImagePicker แต่สามารถระบุได้โดยตรงจากการจัดเก็บ โปรดทราบว่าอุปกรณ์ต่างๆจะเก็บรักษาที่เก็บข้อมูลไว้แตกต่างกันดังนั้นหากคุณมีไฟล์ arrow.gif ในโฟลเดอร์ Appinventor / asset อยู่ตัวอย่างเช่นคุณควร:

    "แฟ้ม: ///sdcard/Appinventor/assets/arrow.gif"
    หรือ
    "/storage/Appinventor/assets/arrow.gif"


คุณสมบัติ
ไม่มี
เหตุการณ์ที่เกิดขึ้น
ไม่มี
วิธีการ

ShareFile (ไฟล์ข้อความ)
    แชร์ไฟล์ผ่านแอพพลิเคชันใด ๆ ที่สามารถติดตั้งบนโทรศัพท์โดยการแสดงรายชื่อแอปที่มีอยู่และอนุญาตให้ผู้ใช้เลือกจากรายการ แอปพลิเคชันที่เลือกจะเปิดขึ้นพร้อมกับแทรกไฟล์ไว้
ShareFileWithMessage (แฟ้มข้อความข้อความตัวอักษร)
    แชร์ไฟล์และข้อความผ่านแอ็พพลิเคชันที่สามารถใช้งานได้ซึ่งติดตั้งอยู่ในโทรศัพท์โดยการแสดงรายการแอพฯ ที่ใช้ได้และอนุญาตให้ผู้ใช้เลือกจากรายการ แอปพลิเคชันที่เลือกจะเปิดขึ้นพร้อมกับใส่ไฟล์และข้อความไว้
ShareMessage (ข้อความตัวอักษร)
    แชร์ข้อความผ่านแอพพลิเคชันใด ๆ ที่สามารถติดตั้งบนโทรศัพท์โดยการแสดงรายชื่อแอพฯ ที่มีอยู่และอนุญาตให้ผู้ใช้เลือกจากรายการ แอปพลิเคชันที่เลือกจะเปิดขึ้นพร้อมกับใส่ข้อความไว้

texting


คอมโพเนนต์ที่จะเมื่อเรียกเมธอด SendMessage ให้ส่งข้อความที่ระบุในคุณสมบัติข้อความไปยังหมายเลขโทรศัพท์ที่ระบุในคุณสมบัติ PhoneNumber

ถ้าคุณสมบัติ ReceivingEnabled ถูกตั้งค่าเป็น 1 ข้อความจะไม่ได้รับ ถ้า ReceivingEnabled มีการตั้งค่าไว้ที่ 2 ข้อความจะได้รับเฉพาะเมื่อแอ็พพลิเคชันกำลังทำงานอยู่เท่านั้น ถ้า ReceivingEnabled ถูกตั้งไว้ที่ 3 จะมีการรับข้อความเมื่อแอ็พพลิเคชันทำงานอยู่และเมื่อแอ็พพลิเคชันไม่ทำงานพวกเขาจะถูกจัดคิวและการแจ้งเตือนจะปรากฏแก่ผู้ใช้

เมื่อมีข้อความถึงเหตุการณ์ MessageReceived จะเพิ่มขึ้นและระบุหมายเลขการส่งและข้อความ

แอปที่มีคอมโพเนนต์นี้จะได้รับข้อความแม้ว่าจะอยู่ในพื้นหลัง (เช่นเมื่อไม่ปรากฏบนหน้าจอ) และแม้ว่าแอปจะไม่ทำงานตราบเท่าที่มีการติดตั้งไว้ในโทรศัพท์ หากโทรศัพท์ได้รับข้อความเมื่อแอปไม่อยู่ในเบื้องหน้าโทรศัพท์จะแสดงการแจ้งเตือนในแถบแจ้งเตือน การเลือกการแจ้งเตือนจะทำให้แอปพลิเคชันขึ้น ในฐานะนักพัฒนาแอปคุณอาจต้องการให้ผู้ใช้ของคุณสามารถควบคุม ReceivingEnabled เพื่อให้พวกเขาสามารถทำให้โทรศัพท์ละเว้นข้อความได้ 


ถ้าคุณสมบัติ GoogleVoiceEnabled เป็นจริงข้อความจะถูกส่งผ่าน Wifi โดยใช้ Google Voice ตัวเลือกนี้กำหนดให้ผู้ใช้มีบัญชี Google Voice และแอป Mobile Voice ติดตั้งอยู่ในโทรศัพท์ ตัวเลือก Google Voice จะใช้ได้เฉพาะกับโทรศัพท์ที่รองรับ Android 2.0 (Eclair) หรือสูงกว่า

หากต้องการระบุหมายเลขโทรศัพท์ (เช่น 650-555-1212) ให้ตั้งค่าคุณสมบัติ PhoneNumber เป็นสตริงข้อความที่มีตัวเลขที่ระบุ (เช่น 6505551212) อาจมีเครื่องหมายขีดคั่นจุดและวงเล็บ (เช่น (650) -555-1212) แต่จะถูกละเลย ช่องว่างอาจไม่รวมอยู่

อีกวิธีหนึ่งสำหรับแอปเพื่อระบุหมายเลขโทรศัพท์คือการรวมคอมโพเนนต์ PhoneNumberPicker ซึ่งจะช่วยให้ผู้ใช้เลือกหมายเลขโทรศัพท์จากหมายเลขที่อยู่ในรายชื่อติดต่อของโทรศัพท์ได้


คุณสมบัติ

GoogleVoiceEnabled
    ถ้าเป็นจริง SendMessage จะพยายามส่งข้อความผ่าน Wifi โดยใช้ Google Voice ซึ่งกำหนดให้แอป Google Voice ต้องได้รับการติดตั้งและตั้งค่าบนโทรศัพท์หรือแท็บเล็ตด้วยบัญชี Google Voice หาก GoogleVoiceEnabled เป็นเท็จอุปกรณ์ต้องมีบริการโทรศัพท์และส่งข้อความเพื่อส่งหรือรับข้อความด้วยคอมโพเนนต์นี้
ข่าวสาร
    ข้อความที่จะถูกส่งเมื่อเรียกเมธอด SendMessage
หมายเลขโทรศัพท์
    จำนวนที่ข้อความจะถูกส่งไปเมื่อเรียกเมธอด SendMessage หมายเลขคือสตริงข้อความที่มีตัวเลขที่ระบุ (เช่น 6505551212) อาจมีเครื่องหมายขีดคั่นจุดและวงเล็บ (เช่น (650) -555-1212) แต่จะถูกละเลย ไม่ควรรวมช่องว่างไว้
ReceivingEnabled
    หากตั้งค่าเป็น 1 (OFF) จะไม่ได้รับข้อความใด ๆ ถ้าตั้งค่าเป็น 2 (FOREGROUND) หรือ 3 (ALWAYS) คอมโพเนนต์จะตอบสนองต่อข้อความถ้ามีการทำงาน ถ้าแอ็พพลิเคชันไม่ทำงานข้อความจะถูกยกเลิกหากตั้งไว้ที่ 2 (FOREGROUND) หากตั้งค่าเป็น 3 (ALWAYS) และแอปไม่ได้ใช้งานโทรศัพท์จะเป็นการแจ้งเตือน การเลือกการแจ้งเตือนจะนำสัญญาณ appand ออกจากเหตุการณ์ MessageReceived ข้อความที่ได้รับเมื่อปิดใช้งาน appis ไว้เฉยๆและเหตุการณ์ MessageReceived ต่างๆอาจเกิดขึ้นเมื่อแอพสร้างขึ้น ในฐานะนักพัฒนาแอปคุณควรกำหนดให้ผู้ใช้ควบคุมพร็อพเพอร์ตี้นี้เพื่อให้โทรศัพท์ที่ใช้งานได้สามารถละเว้นข้อความเมื่อติดตั้งแอป


เหตุการณ์ที่เกิดขึ้น

MessageReceived (หมายเลขข้อความข้อความ textText)
    เหตุการณ์ที่เกิดขึ้นเมื่อได้รับข้อความจากโทรศัพท์


Methods

SendMessage()
    Send a text message

องค์ประกอบที่มองไม่เห็นซึ่งช่วยให้สามารถสื่อสารกับ Twitter เมื่อผู้ใช้เข้าสู่ระบบบัญชี Twitter ของตน (และการให้สิทธิ์ได้รับการยืนยันว่าประสบความสำเร็จโดยเหตุการณ์ที่ไม่ได้รับอนุญาต) มีการดำเนินการเพิ่มเติมอีกหลายอย่าง:

    ค้นหา Twitter สำหรับทวีตหรือป้ายกำกับ (SearchTwitter)
    การส่ง Tweet (Tweet)
    การส่ง Tweet ด้วยรูปภาพ (TweetWithImage)
    การกำกับข้อความไปยังผู้ใช้เฉพาะ (DirectMessage)
    การรับข้อความล่าสุดที่ส่งถึงผู้ใช้ที่เข้าสู่ระบบ (RequestDirectMessages)
    ติดตามผู้ใช้เฉพาะราย (ตาม)
    หยุดการติดตามผู้ใช้เฉพาะ (StopFollowing)
    รับรายชื่อผู้ใช้ตามผู้ใช้ที่เข้าสู่ระบบ (RequestFollowers)
    การรับข้อความล่าสุดของผู้ใช้ตามด้วยผู้ใช้ที่เข้าสู่ระบบ (RequestFriendTimeline)
    ได้รับการกล่าวถึงล่าสุดของผู้ใช้ที่เข้าสู่ระบบ (RequestMentions)

คุณต้องได้รับรหัสผู้บริโภคและความลับของผู้บริโภคสำหรับการให้สิทธิ์ Twitter เฉพาะสำหรับแอปของคุณจาก http://twitter.com/oauth_clients/new


คุณสมบัติ

ConsumerKey
    รหัสผู้บริโภคที่จะใช้เมื่ออนุญาตด้วย Twitter ผ่าน OAuth
ConsumerSecret
    ความลับของผู้ใช้ที่จะใช้เมื่อให้สิทธิ์กับ Twitter ผ่าน OAuth
ข้อความโดยตรง
    คุณสมบัตินี้ประกอบด้วยรายการข้อความล่าสุดที่กล่าวถึงผู้ใช้ที่ลงชื่อเข้าใช้ ตอนแรกรายการว่างเปล่า เมื่อต้องการตั้งค่าโปรแกรมต้อง:

        เรียกใช้วิธีการอนุมัติ
        รอเหตุการณ์ที่ได้รับอนุญาต
        เรียกใช้เมธอด RequestDirectMessages
        รอเหตุการณ์ DirectMessagesReceived

    ค่าของพร็อพเพอร์ตี้นี้จะถูกตั้งค่าเป็นรายการข้อความที่เรียกคืนโดยตรง (และเก็บค่านั้นไว้จนกว่าจะมีการเรียกใช้งาน RequestDirectMessages ตามมา)


สมัครพรรคพวก
    คุณสมบัตินี้ประกอบด้วยรายการผู้ติดตามของผู้ใช้ที่เข้าสู่ระบบ ตอนแรกรายการว่างเปล่า เมื่อต้องการตั้งค่าโปรแกรมต้อง:

        เรียกใช้วิธีการอนุมัติ
        รอเหตุการณ์ที่ไม่ได้รับอนุญาต
        เรียกใช้เมธอด RequestFollowers
        รอเหตุการณ์ FollowersReceived

    ค่าของคุณสมบัตินี้จะถูกตั้งค่าเป็นรายการผู้ติดตาม (และรักษาค่าไว้จนกว่าจะมีการเรียกใช้ RequestFollowers ตามมา)
FriendTimeline
    พร็อพเพอร์ตี้นี้มี 20 ข้อความล่าสุดที่ผู้ใช้ติดตาม ตอนแรกรายการว่างเปล่า เมื่อต้องการตั้งค่าโปรแกรมต้อง:

        เรียกใช้วิธีการอนุมัติ
        รอเหตุการณ์ที่ไม่ได้รับอนุญาต
        ระบุผู้ใช้ที่จะติดตามด้วยการเรียกใช้อย่างน้อยหนึ่งรายการไปยังวิธีการติดตาม
        เรียกใช้เมธอด RequestFriendTimeline
        รอสักครู่ FriendTimelineReceived event


ค่าของคุณสมบัตินี้จะถูกตั้งค่าเป็นรายการข้อความ (และรักษาค่าไว้จนกว่าจะมีการเรียกใช้ RequestFriendTimeline ตามลำดับ)
กล่าวถึง
    พร็อพเพอร์ตี้นี้ประกอบด้วยรายการที่กล่าวถึงผู้ใช้ที่ลงชื่อเข้าใช้ ตอนแรกรายการว่างเปล่า เมื่อต้องการตั้งค่าโปรแกรมต้อง:

        เรียกใช้วิธีการอนุมัติ
        รอเหตุการณ์ที่ไม่ได้รับอนุญาต
        เรียกใช้เมธอด RequestMentions
        รอเหตุการณ์ MentionsReceived

    ค่าของคุณสมบัตินี้จะถูกตั้งค่าเป็นรายการที่กล่าวถึง (และจะรักษาค่าจนกว่าจะมีการเรียก RequestMentions ตามมา)
ผลการค้นหา
    พร็อพเพอร์ตี้นี้ซึ่งว่างเปล่าแรกจะถูกตั้งค่าเป็นรายการผลการค้นหาหลังจากโปรแกรม:

        เรียกใช้เมธอด SearchTwitter
        รอเหตุการณ์ SearchSuccessful


ค่าของพร็อพเพอร์ตี้จะเป็นเช่นเดียวกับพารามิเตอร์ SearchSuccessful โปรดทราบว่าคุณไม่จำเป็นต้องเรียกใช้วิธีอนุญาตก่อนโทร SearchTwitter
ชื่อผู้ใช้
    ชื่อผู้ใช้ของผู้ใช้ที่ได้รับอนุญาต ว่างเปล่าหากไม่มีผู้ใช้ที่ได้รับอนุญาต

เหตุการณ์ที่เกิดขึ้น

DirectMessagesReceived (ข้อความในรายการ)
    เหตุการณ์นี้จะเกิดขึ้นเมื่อได้รับข้อความล่าสุดที่ขอผ่าน RequestDirectMessages รายการของข้อความจะสามารถพบได้ในพารามิเตอร์ข้อความหรือคุณสมบัติข้อความ
FollowersReceived (ผู้ติดตามรายการ 2)
    เหตุการณ์นี้เกิดขึ้นเมื่อมีการเรียกค้นผู้ติดตามทั้งหมดของผู้ใช้ที่เข้าสู่ระบบที่ร้องขอผ่าน RequestFollowers จากนั้นผู้ติดตามสามารถดูรายชื่อผู้ติดตามหรือผู้ติดตามได้
FriendTimelineReceived (รายการเส้นเวลา)
    เหตุการณ์นี้เกิดขึ้นเมื่อได้รับข้อความที่ขอผ่าน RequestFriendTimeline พารามิเตอร์ของไทม์ไลน์และพร็อพเพอร์ตี้ไทม์ไลน์จะมีรายการของรายการซึ่งแต่ละรายการย่อยประกอบด้วยการอัพเดตสถานะของแบบฟอร์ม (ชื่อผู้ใช้)
IsAuthorized ()
    เหตุการณ์นี้จะเพิ่มขึ้นหลังจากที่โปรแกรมเรียกใช้ Authorize ถ้าการให้สิทธิ์สำเร็จ เรียกอีกอย่างว่าหลังจากมีการเรียกร้องให้ CheckAuthorized ถ้าเรามีโทเค็นการเข้าถึงที่ถูกต้องแล้ว หลังจากเหตุการณ์นี้ได้รับการยกวิธีอื่นใดสำหรับคอมโพเนนต์นี้สามารถเรียกได้
MentionsReceived (รายการที่กล่าวถึง)
    เหตุการณ์นี้เกิดขึ้นเมื่อมีการเรียกคืนการอ้างอิงของผู้ใช้ที่ลงชื่อเข้าใช้ผ่านทาง RequestMentions รายการที่กล่าวถึงสามารถพบได้ในพารามิเตอร์ mentions หรือคุณสมบัติ Mentions
SearchSuccessful (list searchResults)
    เหตุการณ์นี้จะเกิดขึ้นเมื่อผลการค้นหาที่ขอผ่าน SearchSuccessful ถูกเรียกค้น รายการผลการค้นหาสามารถพบได้ในพารามิเตอร์ผลลัพธ์หรือพร็อพเพอร์ตี้ Results


วิธีการ

อนุญาต()
    เปลี่ยนเส้นทางผู้ใช้เพื่อเข้าสู่ระบบ Twitter ผ่านเว็บเบราเซอร์โดยใช้โปรโตคอล OAuth หากเรายังไม่มีการให้สิทธิ์
CheckAuthorized ()
    ตรวจสอบว่าเรามีสิทธิ์เข้าถึงอยู่แล้วหรือไม่และถ้าใช่ให้เรียกใช้ตัวจัดการเหตุการณ์ที่ไม่ได้รับอนุญาต
ยกเลิกการอนุญาต ()
    ลบการให้สิทธิ์จาก Twitter จากแอ็พพลิเคชันที่กำลังทำงานอยู่นี้
DirectMessage (ผู้ใช้ข้อความข้อความตัวอักษร)
    การดำเนินการนี้จะส่งข้อความ (ส่วนตัว) โดยตรงไปยังผู้ใช้ที่ระบุ ข้อความจะถูกตัดแต่งถ้ามีอักขระเกิน 160 ตัว

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว
ติดตาม (ผู้ใช้ข้อความ)
    เริ่มต้นตามผู้ใช้
RequestDirectMessages ()
    ขอให้ส่งข้อความตรงถึง 20 รายการล่าสุดที่ส่งถึงผู้ใช้ที่ลงชื่อเข้าใช้ เมื่อมีการดึงข้อความระบบจะเพิ่มเหตุการณ์ DirectMessagesReceived และตั้งค่าคุณสมบัติ DirectMessages ในรายการข้อความ

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว
RequestFollowers ()
    รับผู้ติดตามคุณ
RequestFriendTimeline ()
    ได้รับข้อความล่าสุด 20 ข้อความในไทม์ไลน์ของผู้ใช้
RequestMentions ()
    ขอการกล่าวถึงล่าสุด 20 รายการของผู้ใช้ที่ลงชื่อเข้าใช้ เมื่อมีการเรียกข้อมูลดังกล่าวระบบจะเพิ่มเหตุการณ์ MentionsReceived และตั้งค่าคุณสมบัติ Mentions ไปยังรายการที่กล่าวถึง

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว
SearchTwitter (ข้อความค้นหา)
    การค้นหานี้จะค้นหา Twitter สำหรับข้อความค้นหา String ที่ระบุ

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว
StopFollowing (ผู้ใช้ข้อความ)
    หยุดติดตามผู้ใช้
ทวีต (สถานะข้อความ)
    ข้อความนี้จะส่งทวีตเป็นผู้ใช้ที่ลงชื่อเข้าใช้ด้วยข้อความที่ระบุซึ่งจะถูกตัดแต่งหากมีอักขระเกิน 160 ตัว

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว
TweetWithImage (สถานะข้อความ text imagePath)
    การดำเนินการนี้จะส่งทวีตเป็นผู้ใช้ที่ลงชื่อเข้าใช้ด้วยข้อความที่ระบุและเส้นทางไปยังรูปภาพที่จะอัปโหลดซึ่งจะถูกตัดแต่งหากมีอักขระเกิน 160 ตัว หากไม่พบรูปภาพหรือไม่ถูกต้องการอัปเดตจะไม่ถูกส่ง

    ข้อกำหนด: สิ่งนี้ควรถูกเรียกหลังจากที่เหตุการณ์ที่ได้รับอนุญาตถูกยกขึ้นแสดงว่าผู้ใช้เข้าสู่ระบบ Twitter เรียบร้อยแล้ว

ใบอนุญาตครีเอทีฟคอมมอนส์



แหล่งอ้างอิง
http://ai2.appinventor.mit.edu/reference/components/social.html#Twitter

ไม่มีความคิดเห็น:

แสดงความคิดเห็น